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FOREWORD 



DECsystem-10 Monitor Calls is a complete reference document describing the monitor programmed 
operators (UUOs) and is intended for the experienced assembly languc^e programmer. The information 
presented in this manual reflects the 5,06 release of the monitor. The monitor calls ore grouped in a 
manner that facilitates easy learning, and once they are mastered, the user can refer to the end of the 
Tcfcle of Contents and to the index for an alphabetical list of the UUOs. 

DECsystem-10 Monitor Calls does not include reference material on the operating system commands. 
This information can be found in DECsystem~10 Operating System Commands (DEC-10-MRDC-D). 
Included in DECsystem-10 Operating System Commands are discussions on commands processed by both 
the monitor command lohguage interpreter and the programs in the Batch system. The two manuals, 
DECsystem-10 Monitor Calls and DECsystem-IO Operating System Commands , supersede the Time- 
sharing Monitors manual (DEC-T9~MTZD-D) and all of its updates. 

A third manual. Introduction to DECsystem-10 Software (DEC-10-MZDA-D), is a general overview of 
the DECsystem-10. It is written for the person, not necessarily a programmer, who knows computers 
and computing concepts and who desires to know the relationship between the various components of 
the DECsystem-10. This manual is not intended to be a programmer's reference manual, and therefore, 
it is recommended that it be read at least once before reading the above-mentioned reference docu- 
ments, 

SYNOPSIS, OF DECsystem-10 MONITOR CALLS 

Chapter 1 discusses the format of memory and briefly describes the job data area. Chapter 2 introduces 
all of the monitor programmed operators available to a user program and the various processor modes 
in which a user program operates. The UUOs available for non-I/O operations are presented in 
Chapter 3. These programmed operator are used to obtain execution, core, and segment control; 
program identification; environmental information; and real-time status. An introduction to I/O 
programming is presented in Chapter 4; the services the monitor performs for the user and how the user 
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program obfatns these services are also discussed. \/0 programming specific to the nondirecto»y de- 
vices and directory devices is explained in Chapters 5 and 6, respectively. Algorithms of the mcnitor, 
described in Chapter 7 , give the user an insight into system operation. The appendices contain supple- 
mentary reference material and tables, 

CONVENTIONS USED IN DECsystem-10 MONITOR CALLS 

The following conventions have been used throughout this manual: 

dev: Any logical or physical device name. The colon must be included 

when a device is used as part of a file specification. 

list A single file specification or d string of file specifications, A file 

specification consists of a filename (with or without a filename ex- 
tension), a device name, a directory name, and a protection, 

job n A job number assigned by the system. 

file.ext Any legal filename and filename extension, 

core Decimal number of IK blocks of core (KAIO). 

Decimal number of pages of core (KIIO). 

adr An octal address. 

C(adr) The contents of an octal address, 

fproj,prog] Project-programmer numbers; the square brackets must be included 

in the command string. 

fs Any legal file structure name or abbreviation. 

r$) The symbol used to indicate the ESCAPE Key. 

tx A control character obtained by depressing the CTRL key and then 

the character key x. 

*- A back arrow used in command string to separate the input and output 

file specifications. 

= A equal sign used in a command string to separate the input and out- 

put file specifications. 

* The system program response to a command string. 

The monitor response to a command string. 

^ The symbol used to indicate that the user should depress the RETURN 

key. This key must be used to terminate every command to the monitor 
command language interpreter. 

Underscoring used to indicate computer typeout. 



n A decinrKjI number. 

[directory] A designation identifying a particular disk area. Tliis designation can 

be in the form fproj, prog] which identifies a UFD or fproj,prog,sfd, 
sfd, , . .] which identifies a sub-file directory path branching from a 
UFD. The square brackets are required. 
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CHAPTER 1 
I MEMORY FORMAT 



1 . 1 MEMORY PROTECTION AND RELOCATION 

Each user program is run with the processor in a special mode called the user mode ; in this mode the 
program must operate within an assigned area in core, and certain operations are illegal. Because 
every user has an assigned area in core, the rest of core is unavailable to him. He cannot gain access 
to a protected area for either storage or retrieval of information. 

The assigned area of each user can be divided into two segments. If this is the case, the low segment 
( impure segment) is unique for a given user and can be used for any purpose. The high segment (pure 
segment) can be used, by one user or it can be shared by many users. If the high segment is shared, the 
program is a reentrant program . The monitor usually write -protects the high segment so that the user 
cannot alter its contents. This is done, for example, when the high segment is a pure procedure to be 
used reentrantly by many users. One high pure segment can be used with any number of low impure 
segments. Any user program that attempts to write in a write -protected high segment is aborted and 
receives an error message. If the monitor defines two segments but does not write-protect the high 
segment, the user has a two-segment non-reentrant program (refer to Paragraph 3.2.4). 

The DECsystem-TO monitor defines the size and position of a user'^s area. On KAlO-based systems 
(DECsystem-1040, -1050, and -1055), the monitor uses relocation by specifying protection and re- 
location addresses for the low and high segments. The protection address is the maximum relative 
address the user can reference. The relocation address is the absolute core address qf the first loca- 
tion in the segment, as seen by the monitor in the hardware. The monitor defines these addresses by 
loading four 8-bit registers (two 8-bit registers in a KAIO based system with the KTIO option instead of 
the KTIOA option), each of which correspond to the left eight bits of an 18-bit PDP-IO address. 
Thus, segments always contain a multiple of 1024 words. 

On KllO-based systems (DECsystem-1070 and -1077), the user's area is pagfe mapped . This means 
that each page (a page consists of 512 words) of the user's area is associated with a page of physical 
core memory. Because the assignment of physical pages of core does not need to be contiguous, the 
monitor has greater freedom in allocating core. The monitor associates (maps) pages in the user's area 
with physical pages in core in such a way that the user appears to have one or two segments as with a 
KAlO-based system. Therefore, in most cases, the user does not need to be concerned with the type 

1-1 March 1973 



nOfllTOR CALLS -360- 

of processor on which his program is running. However, the unit of core allocation is different on the 
two processors. The unit of allocation on the KAIO is 1024 words (IK) and on the K 110, is 512 words 
(1 page). 

In general, the term mapping refers to both relocation (KAIO) and page mapping (KI10). On either 
processor, a user address is called a relative or virtual address before it is mapped, and an absolute 
or physical address after it is mapped. 

To take advantage of the fast accumulators, memory addresses 0-1 7g are not mapped and all users have 
access to the accumulators. Therefore, relative locations 0-17o cannot be referenced by a user's 
program. The monitor saves the user's accumulators in this area when the user's program is not running 
anti while the monitor is servicing a DUO from the user. Refer to the PDP-10 System Reference 
Manual for a more complete description of the relocation and mapping hardware. 

1.2 USER'S CORE STORAGE 

A user's core storage consists of blocks of memory, the sizes of which are an integral multiple of 1024 
(2000g) words on the KAlO-based system and 51 2^ q (lOOOg) words on the K IlO-based system. In a 
non-reentrant monitor, the user's core storage is a single contiguous block of memory. After mapping, 
the first -address in a block is a multiple of 2000g or lOOOg. The relative user and relocated address 
configurations on the KAIO are shown in Figure 1-1, where P, , R, , Pj., and R^ are the protection 
and relocation addresses for the low and high segments, respectively. If the low segment is more than 
half the maximum memory capacity (P^> 400000), the high segment starts at the first location after 
the low segment (at Pj^ + 2000). The high segment is limited to 128K. The relative user address con- 
figurations on the K 110 are shown in Figure 1-2, where P. and Pj, are the protection addresses for 
the low and high segments, respectively. 

Two methods are available to the user for loading his core area. The simplest way is to load a core 
image stored on a retrievable device (refer to RUN and GET commands). The other method is to use 
the relocatable binary loader to link-load binary files. The user can then write the core image on 
a retrievable device for future use (refer to SAVE command). 

1.2.1 Job Data Area (JOBDAT) 

The first 140 octal locations of the user's core area are always allocated to the job data area (refer to 
Table 1-1). Locations in this area are given mnemonic assignments where the beginning characters are 
.JB. The job data area provides storage for specific information of interest to both the monitor and the 
user. Some locations, such as .JBSA and .JBDDT, are set by the user's program for use by the 
monitor. Other locations, such as .JBREL, are set by the monitor and are used by the user's program. 
In particular, the right half of .JBREL contains the highest legal address set by the monitor when the 
user's core allocation changes. 
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Table 1-1 

Job Data Area Locations 

(for user-program reference) 



Name 



Octal 
Location 



Description 



JBUUO 

JB41 

JBERR 

JBREL 

, JBBLT 

.JBDDT 

.JBCN6 

.JBPFI 
JBHRL 



40 



41 



42 



44 



45 



74 



106 



114 
(value) 

115 



User's location 408- Used by the hardware when proc- 
essing user UUOs (001 through 037) for storing op code 
and effective address. 

User's location 4l8. Contains the beginning address of 
the user's programmed operator service routine (usually 
a JSR or PUSHJ). 

Left half: Unused. 

Right half: Accumulated error count from one system 
program to the next. System programs should be written 
to look at the right half only. 

Left half: Zero. 

Right half: The highest relative core location available 
to the user (i.e. , the contents of the memory protection 
register when this user is running). 

Three consecutive locations when the LOADER puts a 
BLT instruction and a CALLI UUO to move the program 
down on top of itself. These locations are destroyed on 
every executive UUO by the executive pushdown list. 

Left half: The last address of DDT. 

Right half: The starting address of DDT. If contents are 

0, DDT has not been loaded. 

Six temporary locations used by the CHAIN program 
(refer to the LOADER manual) after it releases all I/O 
channels. .JBCN6 is defined to be in .JBJDA. 

All user I/O must be to locations greater than .JBPFI. 

Left half: First relative free location in the high seg- 
ment (relative to the high segment origin so it is the 
same as the high segment length). Set by the LOADER 
and subsequent GETs, even if there is no file to initial- 
ize the low segment. The left half is a relative quan- 
tity because the high segment can appear at different 
user origins at the same time. The SAVE command uses 
this quantity to know how much to write from the high 
segment. 

Right half: Highest legal user address in the high seg- 
ment. Set by the monitor every time the user starts to 
run or does a CORE or REMAP UUO. The word is 
>401777 unless there is no high segment, in which case 
it will be zero. The proper way to test if a high seg- 
ment exists is to test this word for a non-zero value. 
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Table r-1 (Coni) 

Job Dafa Area Locations 

(for user-program reference) 



Name 



JBSYM 



JBUSY 



JBSA 



JBFF 



JBREN 



JBAPR 



Octal 
Location 



116 



117 



120 



121 



124 



125 



JBCNI 
JBTPC 
JBOPC 



126 
127 
130 



Description 



Contains a pointer to the symbol table created by link- 
ing loader. 

Left half: Negative of the length of the symbol table. 
Right half: Lowest address used by the symbol table. 

Contains a pointer to the undefined symbol table created 
by linking loader or defined by DDT. This location has 
the same format as .JBSYM. There are no undefined 
symbols if the contents is >0. 

Left half: First free location in low segment (set by 

loader) . 

Right half: Starting address of the user's program. 

Left half: Zero. 

Right half: Address of the first free location following 

the low segment. Set to C (.JBSA), ^ by RESET UUO. 

Left half: Unused. 

Right half: REENTER starting address. Set by user or 
by loader and used by REENTER command as an alternate 
entry point. 

Left half: Zero. 

Right half: Set by user program to trap address when 
user is enabled to handle APR traps such as illegal 
memory, pushdown overflow, arithmetic overflow, and 
clock. SeeAPRENBUUO. 

Contains state of APR as stored fay CONI APR when a 
user-enabled APR trap occurs. 

Monitor stores PC of next instruction to be executed 
when a user-enabled APR trap occurs. 

The previous contents of the job's last user mode pro- 
gram counter are stored here by monitor on execution 
of a DDT, REENTER, START, or CSTART command. 
After a user program HALT instruction followed by a 
START, DDT, CSTART, or REENTER command, .JBOPC 
contains the address of the HALT. To proceed at the 
address specified by the effective address, it is 
necessary for the user or his program to recompute the 
effective address of the HALT instruction and to use 
this address to start. Similarly, after an error during 
execution of a UUO followed by a START, DDT, 
CSTART, or REENTER command, .JBOPC points to the 
address of the UUO. For example, in DDT to continue 
after a HALT, type 

.JBOPC/1 0000,, 3010 JRST@.$X 
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Table 1-1 (Cont) 
Job Data Area Locations 
(for user-program reference) 



Name 



JBCHN 



JBCOR 



JBINT 

JBOPS 
JBCST 
. JBVER 



Octal 
Location 



131 



133 



134 

135 
136 
137 



. JBDA 



140 



Description 



Left half: Zero or the address of first location after first 
FORTRAN IV loaded program. 

Right half: Address of first location after first FORTRAN 
IV Block Data. 

Left half: Highest location in low segment loaded with 
non-zero data. No low file written on SAVE or SSAVE 
if less than 140. Set by the LOADER. 
Right half: User argument on last SAVE or GET command. 
Set by the monitor. 

Left half: Reserved for the future. 

Right half: Zero or the address of the error-intercepting 

block (refer to Paragraph 3. 1 .3.2). 

Reserved for all operating systems. 

Reserved for customers. 

Program version number. The bits are defined as follows: 

Bits 0-2 The group who last modified the program 

= Digital development group. 

1 = Other Digital employees. 
2-4 = Reserved for customers. 

5-7 = Reserved for customer's users. 

Bits 3-11 Digital's major version number. Usually 

incremented by 1 after a release. 

Bits 12-17 Digital's minor version number. Usually 
0, but may be used if an update is needed 
after work has begun on a new major ver- 
sion. 

Bits 18-35 Edit number. Usually not reset. 

The VERSION and the SET WATCH VERSION commands 
output the version number in standard format. Refer to 
DECsystem-10 Operating System Commands . 

The value of this symbol is the first location available 
to the user. 



NOTE: Only those JOBDAT locations of significant importance to the user are given in this 
table. JOBDAT locations not listed include those that are used by the monitor and those 
that are unused at present. User programs should not refer to any locations not listed above 
because such locations are subject to change. 
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JOBDAT is loaded automatically, if needed, during the loader's library search for undefined global 
references, and the values are assigned to the mnemonics. JOBDAT exists as a .REL file on device 
SYS: for loading with user programs that symbolically refer to the locations. User programs should 
reference locations by the assigned mnemonics, which must be declared as EXTERN references to the 
assembler. All mnemonics in this manual with a .JB prefix refer to locations in the job data area. 

1 .2.2 Vestigial Job Data Area 

A few constant data in the job data area may be loaded by a two-segment, one-file program without 
using instructions on a GET command (.JB41, .JBREN, .JBVER), and some locations are loaded by the 
monitor on a GET (.JBSA, .JBCOR, .JBHRL). The vestigial job data area (the first 10 locations of 
the high segment) is reserved for these low-segment constants; therefore, a high-segment program is 
loaded into 400010 instead of 400000 (refer to Table 1-2). With the vestigial job data area in the 
high segment, the loader automatically loads the constant data into the job data area without requir- 
ing a low file on a GET, R, or RUN command, or a. RUN UUO. SAVE will write a low file for a 
two-segment program only if the LH of .JBCOR is 140g or greater. 



Symbol 



.JBHSA 
.JBH41 
.JBHCR 
.JBHRN 

.JBHVR 

.JBHNM 

.JBHSM 



JBHDA 



Table 1-2 
Vestigial Job Data Area Locations 



Octal 
Location 




1 
2 
3 

4 
5 
6 

7 
10 



Description 



A copy of .JBSA. 

A copy of .JB41. 

A copy of .JBCOR. 

LH: restores the LH of .JBHRL, 
RH: restores the RH of JBREN. 

A copy of .JBVER. 

High segment name set on a SAVE . 

A pointer to the high-segment symbols, 
if any. 

Reserved for future use. 

First location not used by vestigial job 
data area. 



tRelative to origin of high segment, usually .JBHGH - 400000g. 
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CHAPTER 2 

INTRODUCTION TO USER PROGRAMMING 



2.1 PROCESSOR MODES 

In a single-user, non-Hmesharing system, the user's program is subject only to those conditions 
inherent in the hardware. The program must 

a. Stay within the memory capacity. 

b. Observe the hardware restrictions placed on the use of certain memory locations. 

c. Observe the restriction on interrupt instructions. 

With timesharing, the hardware limits the central processor operations to' one of three modes: user 
mode, user I/O mode, and executive mode. 

2.1.1 User Mode 

Normally, user programs run with the processor in user mode and must operate within an assigned area 
of core. In user mode, certain instructions are illegal. User mode is used to guarantee the integrity of 
the monitor and each user program. The user mode of the processor is characterized by the following: 

a. Automatic memory protection and mapping (refer to Chapter 1). 

b. Trap to absolute location 40 in the monitor on any of the following: 

(1) Operation codes 040 through 077 and operation code 00, 

(2) Input/output instructions (DATAI, DATAO, BLKI, BLKO, CONI, CONO, 
CONSZ, and CONSO), 

(3) HALT (i.e., JRST 4,), 

(4) Any JRST instruction that attempts to enter executive mode or user I/O mode. 

c. Trap to relative location 40 in the user area on execution of operation codes 001 
through 037. 

2.1.2 User I/O Mode 

The user I/O mode (bits 5 and 6 of PC word = 1 1) of the central processor allows privileged user pro- 
I grams to be run with automatic protection and mapping in effect, as well as the normal execution of 
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all defined operation codes. The user I/O mode provides some protection against partially debugged 
monitor routines and permits infrequently used device service routines to be run as a user job. Direct 
control of special devices by the user program is particularly important in real-time applications. 

To utilize this mode, the user must have bit 15 (JB.TRP) set in the privilege word. RESET AC, or 
CALU terminates user I/O mode. User I/O mode is not used by the monitor and is normally not 
available to the timesharing user (refer to Paragraph 3.8.3). 

2.1.3 Executive Mode 

The monitor operates with the processor in executive mode, which is characterized by special 
memory protection and mapping (refer to Chapter 1) and by the normal execution of all defined 
operation codes. 

User programs run in user mode; therefore, the monitor must schedule user programs, service interrupts, 
perform all input and output ofjerations, take action when control returns from a user program, and 
perform any other legal user-requested operations that are not available in user mode. The services 
the monitor makes available to user-mode programs and how a user program obtains these services, are 
described in Chapters 3 and 4. 

2.2 PROGRAMMED OPERATORS (UUOs) 

Operation codes 000 through 077 in the PDP-10 are programmed operators, sometimes referred to as 
UUOs. They are software -implemented instructions because from a hardware point of view, their 
function is not pre-specified. Some of these op-codes trap to the monitor, and the rest trap to the 
user program. 

After the effective address calculation is complete, the contents of the instruction register, along with 
the effective address, are stored, and an instruction is executed out of the normal sequence. 

Although there is one operating system for all configurations of the DECsystem-10, some UUOs may not 
be included in each DECsystem-10. This is especially true of the DECsystem-1040, the basic system 
intended for small installations who do not want all of the system's features because of a constraint on 
core. UUOs are deleted from the DECsystem-1040 by feature test switches defined at MONGEN time. 
In the standard DECsystem-1040, many of these switches are off, and therefore, the corresponding 
UUOs are not available. This saves core but limits various features of the operating system. In the 
UUO descriptions that follow, footnotes indicate if the switch is normally absent in the DECsystem- 
1040. If not stated, the UUO is available on all configurations of the DECsystem-10. 
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2.2.1 Operation Codes 001-037 (User UUOs) 

Operation codes 001 through 037 do not affect the mode of the central processor; thus, when executed 
in user mode, they trap to user location 40, which allows the user program complete freedom in the 
use of these programmed operators. 

If a user's undebugged program accidentally executes one of these op-codes when the user did not 
intend to use it, the following error message is normally issued: 

HALT AT USER PC addr 

this message is given because the user's relative location 41 contains HALT (unless his program has 
overtly changed it) which is provided by the loader; addr is the location of the user UUO. 



2.2.2 Operation Codes 040-077 and 000 (Monitor UUOs) 

Operation codes 040 through 077 and 000 trap to absolute location 40, with the central processor in 
executive mode. These programmed operators are interpreted by the monitor to perform I/O operations 
and other control functions for the user's program. 

Operation code 000 always returns the user to monitor mode with the error message: 
? ILLEGAL UUO AT USER PC addr 

Table 2-1 lists the operation codes 040 through 077 and their mnemonics. 





Table 2 
Monitor Programm 


-1 

ed Operators 






Op Code 


Call 


Function 




040 
041 

042 


CALL AC, [SIXBIT/NAME/1 , or 
NAME AC, 

INIT D, MODE 
SIXBIT/DEV/ 
XWD OBUF, IBUF 
error return 
normal return 


Programmed ope 
Paragraph 2.2.i 

Select I/O devi 
4.2.3). 

No operation 


rdtor extension (refer to 
>.l). 

ce (refer to Paragraph 




043 
044 
045 




No operation 
No operation 
No operation 


^ Reserved for installation- 
dependent definition. 




046 




No operation 
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Table 2-1 (Cont) 
Monitor Programmed Operators 



Op Code 


Call 


Function 


047 


CALLI AC, N 


Programmed operator extension (refer to 
Paragraph 2.2.2.1). 


050 


OPEN, D, E 

error return 

normal return 

E: EXP STATUS 
SIXBIT /DEV/ 
XWD OBUF, IBUF 


Select I/O device (refer to Paragraph 
4.2.3). 


051 


TTCALL AC, ADR 


Extended operations on job-controlling 
terminal (refer to Paragraph 5.10.3). 


052 




Reserved for future expansion by DEC. 


053 




Reserved fw future expansion by DEC. 


054 




Reserved for future expansion by DEC. 


055 


RENAME D, E 

error return 

normal return 

E: SIXBIT /RLE/ 
SIXBIT /EXT/ 
EXP <PROT> B8+DATE 
XWD PROJ, PROG 


Rename or delete a file (see Section 
4.4.3). 


"^56 


IN D, 

normal return 
error or EOF return 


INPUT and skip on error or EOF (see 
Section 4.5). 


057 


OUT D, 
normal return 
error return 


OUTPUT and skip on error or EOT (see 
Section 4.5). 


060 


SETSTS D, STATUS 


Set file status (see Section 4.6.2). 


061 


STATO D, BITS 

RO: NO SELECTED BITS = 1 

R1: SOME SELECTED BITS = 1 


Skip if file status bits = 1 (see Section 
4.6.1). 


062 


GETSTS D, E 


Copy file status to E (see Section 4.6. 1). 


063 


STATZ D, BITS 

RO: SOME SELECTED BITS = 1 

R1: ALL SELECTED BITS = 


Skip if file status bits = (see Section 
4.6.1). 


064 


INBUF D, N 


Set up input buffer ring with N buffers 
(refer to Paragraph 4,3.2). 


065 


OUTBUF D, N 


Set up output buffer ring with N buffers 
(refer to Paragraph 4.3.2). 


066 


INPUT D, 


Request input or request next buffer (refer 
to Paragraph 4.5). 
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Op Code 


Call 


Function 


067 


OUTPUT D, 


Request output or request next buffer (refer 
to Paragraph 4.5). 


070 


CLOSE D, 


Terminate file operation (refer to Paragraph 
4.7). 


071 


RE LEAS D, 


Release device (refer to Paragraph 4.8. 1). 


072 


MTAPE D, N 


Perform tape positioning operation (refer 
to Paragraphs 5.5.3 and 6.1.6.5). 


073 


UGETF D, 


Get next free block number on DECtape 
(refer to Paragraph 6. 1 .6.3). 


074 


USETI D, E 


Set next input block number (refer to 
Paragraphs 6.1.6.1 and 6.2.9.2). 


075 


USETOD, E 


Set next output block number (refer to 
Paragraphs 6. 1.6. 2 and 6. 2. 9. 2). 


076 


LOOKUP D, E 
error return 
normal return 
E: SIXBIT/FILE/ 

SIXBIT /EXT/ 



XWD PROJ, PROG 


Select a file for input (refer to Paragraph 
4.4.1). 






077 


ENTER D, E 
error return ^ 
normal return 
E: SIXBIT /FIL^ 

SIXBIT /EXT/ 



XWD PROJ, PROG 


Select a file for output (refer to Paragraph 
4.4.2). 






100 


UJEN 


Dismiss real-time interrupt (refer to 
Paragraph 3.8.4). 



2.2.2. 1 CALL and CALLI - Operation codes 040 through 077 limit the monitor to 40^ operations. 
The CALL operation extends this set by specifying the name of the operation by the contents of the 
location specified by the effective address (e.g. , CALL [SIXBIT /EXIT/3 ). This capability provides 
for indefinite extendability of the monitor operations, at the overhead cost to the monitor of a table 
lookup. 

The CALLI operation eliminates the table lookup of the CALL operation by having the programmer or 
the assembler perform the lookup and specify the index to the operation in the effective address of 
the CALLI. Table 2-2 lists the monitor operations specified by the CALL and CALLI operations. 
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Table 2-2 
CALL and CALLI Monitor Operations 



CALL! 


CALU^ 
Mnemonic 


CALL 


Function 


CALLI AC, -2 

. . . -n 




Customer defined 


Reserved fw definition by 
each customer installation. 


CALU AC, -1 


UGHTS 


CALL AC, [SIXBITAIGHTS/] 


Display AC in console lights 
(refer to Paragraph 3.6.4.2). 


CALLI AC, 


RESET 


CALL [SIXBIT/RESET/1 
return 


Reset I/O device (refer to 
Paragraph 4.1 .2). 


CALU AC, 1 


DPTIN 


MOVEI AC, BUFFER 

CALL AC, tSIXBIT/DDTIN/] 

only return 


DDT mode console input 
(refer to Paragraph 5.9.2). 


CALU AC, 2 


SETDDT 


MOVEI AC, DDT-start-adr 
CALL AC, [SIXBIT/SETDDT/] 
only return 


Set protected DDT starting 
address (refer to Paragraph 
3.1.1.1). 


CALU AC, 3 


DDTOUT 


MOVEI AC, BUFFER 

CALL AC, rSIXBITA)DTOUT/j 

only return 


DDT mode console output 
(refer to Paragraph 5.9.2). 


CALU AC, 4 


DEVCHR , 


MOVE AC, [SIXBIT/dev/l or 
MOVEI AC, channel no. 
CALL AC, [SIXBIT/DEVCHR/1 
only return 
C(AC) = if no such device 
C(AC) = DEVMOD word of device 
data block if device is 
found . 


Get device characteristics 
(refer to Paragraph 4.10.2). 


CALU AC, 5 


DDTGT 


CALL AC, [SIXBIT/DDTGT/I 
only return 


No operation, historical 
UUO. 


CALU AC, 6 


GETCHR 


AC: = SIXBIT/DEV/ 

CALL AC, [SIXBIT/GETCHR/j 

only return 


Same as CALLI AC, 4. 


CALU AC, 7 


DDTRL 


CALL AC, tSIXBIT/bDTRL/] 
only return 


No operation; historical 
UUO. 


CALL AC, 10 


WAIT 


AC field is software channel number. 
CALL AC, [SIXBIT/AVAIT/I 
only return 


Wait until device is inactive 
(refer to Paragraph 4.5.3). 


CALU AC, n 


CORE 


MOVE AC, rXWD HIGH ADR or 0, 
LOW ADR or 0] 
CALL AC, [SIXBIT/COR^] 
error return, assignment unchanged 
normal return, new assignment 
AC: = max. core available (in IK 

blocks) on error or normal 

return. 


Allocate core (refer to 
Paragraph 3.2.3). 
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lONITOR CALLS 



CALLI 



CALLI ' 
Mnemonic 



CALL 



Function 



CALL! AC, 12 



CALU AC, 13 



CALU AC, 14 



CALLI AC, 15 



CALLI AC, 16 



CALLI AC, 17 



CALLI AC, 20 



CALLI AC, 21 



CALLI AC, 22 



CALLI AC, 23 



EXIT 



UTPCLR 



DATE 



LOGIN 



tt 



APRENB 



LOGOUT 



tt 



SWITCH 



REASSI 



TIMER 



MSTIME 



CALL AC, [SIXBlT/EXIT/:i 

return 

If AC ^ 0, devices ore not released 

and CONT and CCONT commands 

are effective. 

AC field is software channel number 
CALL AC, [SIXBITAlTPCLR/j 
only return 

CALL AC, rSIXBIT/t)ATE/] 
only return 
AC: = date in compressed format 

MOVE AC, [XWD -N, LOC] 
CALL AC, [SIXBITAOGIN/] 
RO: return 

Does not return if C(RO) is a 

HALT instruction. 

MOVEI AC, BITS 

CALL AC, [SIXBIT/APRENB/I 

return 

CALL AC, [SIX BIT AOG OUT/] 
no return 



CALL AC, [SIX BIT/SWITCH/] 
return 
AC: contents of console data 
switches 

MOVE AC, job number 

MOVEAC+1, [SIXBIT/DEV/j 

CALL AC, [SIXBIT/REASSI/I 

return 
If C(AC) = on return, the job spec- 
ified has not been initialized. If 
C(AC+1) = on return, the device is 
not assigned to calling job, or device 
isHY. 

CALL AC, [SIXBITAlMER/l 
return 
AC: = time in jiffies, right 
justified. 

CALL AC, [SIXBIT/MSTIME/I 
return 

AC: = time in milliseconds, right- 
justified. 



Stop job, may release de- 
vices depending on contents 
of AC (refer to Paragraph 
3.1.2.3). 

Clear DECtape directory 
(refer to Paragraph 6. 1 .6.4), 

Return date (refer to Para- 
graph 3.6.1 .1). 

Privileged UUO in that the 
calling job must not be logged 
in. Is a no-op if executed 
by a job already logged-in. 

Enable central processor 
traps (refer to Paragraph 
3.1.3.1). 

Privileged UUO available 
only to system-privileged 
programs. Is treated like an 
EXIT UUO if executed by a 
non-system-privileged pro- 
gram. 

Read console data switches 
(refer to Paragraph 3.6.4.1) 



Reassign device (refer to 
Paragraph 4.8.3). 



Read time of day in clock 
ticks (refer to Paragraph 
3.6.1.2). 

Read time of day in milli- 
seconds (refer to Paragraph 
3.6.1.3). 
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CALL and CALLI Monitor Operations 



CALLI 


CALU^ 
Mnemonic 


CALL 


Function 


CALU AC, 24 


GETPPN 


CALL AC, [SIXBIT/GETPPN/1 

normal return 

alternate return 
AC: = XWD proj. no., prog. no. of 
this job. Alternate return is 
taken only if job is privileged 
and the same proj -prog number 
occurs twice in the table of 
jobs logged in. 


Return project-programmer 
number of job (refer to 
Paragraph 3.6.2.3). 


CALLI AC, 25 


TRPSET 


MOVE AC, rXWD N, LOC] 
CALL AC, [SIXBITARPSET/I 
error return 
normal return 
LOC: JSRTRAP 


Set trap for user I/O mode 
(refer to Paragraph 3.8.3). 


CALLI AC, 26 


TRPJEN 


CALL [SIXBITARPJEN/I 


Illegal UUO; replaced by 
UJEN (op code 100). 


CALLI AC, 27 


RUNTIM 


MOVE AC, job number or 
CALL AC, [SIXBIT/RUNTIM/I 
only return 

AC: = running time of job 
AC: = if non-existent job 


Return the jobs running time 
in milliseconds (refer to 
Paragraph 3.6.2.1). 


CALU AC, 30 


PJOB 


CALL AC, [SIXBIT/PJOB/j 

return 

AC: = job number, right-justified 


Return job number (refer to 
Paragraph 3.6.2.2). 


CALLI AC, 31 


SLEEP 


MOVE AC, time to sleep in seconds 
CALL AC, [SIXBIT/SLEEP/1 
return 


Stop job for specified time 
in seconds (refer to Para- 
graph 3.1.4.1). 


CALLI AC, 32 


SETPOV 


CALL AC, [SIXBIT/SETPOV/I 
return 


Superseded by APRENB UUO. 


CALU AC, 33 


PEEK 


MOVEI AC, exec adr 
CALL AC, [SIX BIT/PEEK/I 
return 
AC: = C (exec -adr) 


Return contents of executive 
address (refer to Paragraph 
3.6.3.1). 


CALU AC, 34 


GETLIN 


CALL AC, CSIXBIT/GETLIN/] 
return 
AC: = SIXBIT TTY name, left- 
justified (e.g., CTY, TTY27) 


Return SIXBIT name of at- 
tached terminal (refer to 
Paragraph 5.9.4). 


CALU AC, 35 


RUN 


MOVSI AC, start adr increment 
HRRI AC, E 
RUN AC, 
error return 
normal return 


Transfer control to selected 
program (refer to Paragraph 
3.3.1). 
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CALL and CALLI Monitor Operations 



CALLI 



CALLI ' 
Mnemonic 



CALL 



Function 



CALLI AC, 35 
(continued) 



RUN 



CALLI AC, 36 



CALLI AC, 37 



CALLI AC, 40 



SETUWP 



REMAP 



GETSEG 



CALLI AC, 41 



GETTAB 



CALU AC, 42 



CALLI AC, 43 



CALLI AC, 44 



SPY 



SETNAM 



TMPCOR 



E: SIX BIT/DEVICE/ 
SIXBIT/1=ILE/ 
SIX BIT/EXT/ 


XWD proj no. prog no 
XWD 0; optional core assignment 

MOVEI AC, BIT 
SETUWP AC, 
error return 
normal return 

MOVEI AC, highest adr. in low seg 
REMAP AC, 
error return 
normal return 

MOVEI AC, E 
GETSEG AC, 
error return 
normal return 
E; SIX BIT/DEVICE/ 

SIXBIT/1=ILE/ 

SIX BIT/EXT/ 



XWD proj no, prog no 



MOVSI AC, job no. or index no. 
HRRI AC, table no. 
GETTAB AC, 
error return 
normal return 

C(AC) unchanged on error return 
AC: = table entry if table is defined 
and index is in range. 

MOVEI AC, highest physical adr. 

desired 

SPY AC, 

error return 

normal return 

MOVE AC, [SIX BIT/NAME/I 

SETN/^M AC, 

return 

MOVE AC, [XWD CODE, BLOCK] 
TMPCOR, 
error return 
normal return 



Set or clear user mode write 
protect for high segment 
(refer to Paragraph 3.2.4). 

Remap top of low segment 
into high segment (refer to 
Paragraph 3.3.3). 

Replace high segment in 
user's addressing space (re- 
fer to Paragraph 3.3.2). 



Return contents of monitor 
table or location (refer to 
Paragraph 3.6.3.4). 



Make physical core be high 
segment for examination of 
monitor (refer to Paragraph 
3.6.3.2). 



Set program name in monitor 
job table (refer to Paragraph 
3.4.1). 

Allow temporary in-core 
file storage for job (refer to 
Paragraph 3.5. 1). 
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Table 2-2 (Cont) 
CALL and CALLI Monitor Operations 



CALLI 


CALLI ^ 
Mnemonic 


CALL 


Function 


CALLI AC, 44 
(continued) 


TMPCOR 


BLOCK: XWD NAME, 

lOWD BUFFLEN, BUFFER 
AC: = value depending on CODE and 
whether error or normal return 
is taken. 




CALU AC, 45 


DSKCHR 


MOVE AC, [XWD+N, LOC] 
DSKCHR AC, 
error return 
normal return 

AC: = XWD status, configuration 

LOC:= SIX BIT/NAME/ 

°\ 

) values returned 

1 


Return disk characteristics 
(refer to Paragraph 6.2.9.13). 








CALU AC, 46 


SYSSTR 


" J 
MOVEI AC, or 
MOVE AC, [SIXBIT/FSNAME/j 
SYSSTR AC, 

error return - not a file structure 
normal return 
AC: = next file structure name in 
SIXBIT, left-justified 


Return next f i le structure 
name (refer to Paragraph 
6.2.9.10). 


CALU AC, 47 


JOBSTR 


MOVE AC, [XWD N, LOC] 
JOBSTR AC, 
error return 
ncrmal return 
AC: = argument 

Contents Use 
LOC/SIXBITAlAME/or - 1 org 
LOC+lAWDproj no. 

prog. no. value 
lOC+2/status bits value 


Return next file structure 
name in the jobs search list 
(refer to Paragraph 6.2.9.8). 


CALU AC, 50 


STRUUO 


MOVE AC, [XWD N, LOC] 
STRUUO AC, 
error return 
normal return 
AC: = status or error code 

Contents Use 
LOCrfunction 

numbers org 
LOC+1 : org depending 
on function 

! number 


Manipulate file structures 
(refer to Paragraph 6.2.9.7). 


CALLI AC, 51 


SYSPHY 


MOVEI AC, or last unit name 
SYSPHY AC, 
error return 
normal return 


Return all physical disk units 
(refer to Paragraph 6.2.9.11). 
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CALLI 



CALLI AC, 52 
CALLI AC, 53 



CALU AC, 54 



CALLI AC, 55 



CALLI AC, 56 



CALLI AC, 57 



CALLI AC, 60 



CALLI AC, 61 



CALLI AC, 62 



CALLI AC, 63 



CALLI ' 
Mnemonic 



FRECHN 
DEVTYP 



DEVSTS 



DEVPPN 



SEEK 



ttt 



RTTRP 



LOCK 



JOBSTS 



LOCATE 



WHERE 
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CALL and CALLI Monitor Operations 



CALL 



MOVE AC, [SIXBIT/dev/l or 
MOVEI AC, channel no. 
DEVTYP AC, 
error return 
normal return 

MOVEI AC, channel no. of device 
DEVSTS AC, 
error return 
normal return 

MOVE AC, [SIXBIT/DEV/I 
DEVPPN AC, 
error return 
normal return 
AC: = XWD pro j -prog, number on a 
normal return 

AC is software channel number 

SEEK AC, 

return 

MOVEI AC, RTBLK 
RTTRP AC, 
error return 
normal return 

MOVE AC, CXWD high sag 
code, low seg code] 
LOCK AC, 
error return 
normal return 

MOVEI AC, channel no. or 
MOVN! AC, iob 
JOBSTS AC, 
error return 
normal return 

MOVEI AC, location 
LOCATE AC, 
error return 
normal return 

MOVEI AC, channel no. or 
MOVE AC, [SIXBIT/dev/] 
WHERE AC, 
error return 
normal return 



NONITOR CALLS 



Function 



Reserved for future use. 

Return properties of device 
(refer to Paragraph 4. 10.3). 



Return hardware device 
status word (refer to Para- 
graph 4.10. 1). 

Return the project program- 
mer number associated with 
a device (refer to Paragraph 
6.2.9.12). 



Perform a SEEK to current 
selected block for software 
channel AC (refer to Para- 
graph 6.2.9.3). 

Connect real-time devices to 
PI system (refer to Paragraph 
3.8.1). 



Lock job in core (refer to 
Paragraph 3.2.2). 



Return status information 
about device TTY and/or 
controlled job (refer to 
Paragraph 5.9.4.4). 

Change the I'ob's logical 
station (refer to Paragraph 
3.4.3). 

Return the physical station 
of the device (refer to 
Paragraph 4. 10. 5). 
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CALLI 



CALU AC, 64 



CALLI AC, 65 



CALLI AC, 66 



CALLI ' 
Mnemonic 



DEVNAM 



CTLJOB 



GOBSTR 



CALLI AC, 67 
CALLI AC, 70 
CALLI AC, 71 



CALLI AC, 72 



ACTIVATE 

DEACTIVATE 

HPQ 



HIBER 



CALLI AC, 


73 


WAKE 


CALU AC, 


74 


CHGPPN'^ 


CALLI AC, 


75 


SETUUO 


CALLI AC, 


76 


DEVGEN 



CALL 



MOVEI AC, channel no. or 
MOVE AC, [SIXBIT/dev/] 
DEVNAM AC, 
error return 
normal return 

MOVE AC, job number 
CTLJOB AC, 
error return 
normal return 

MOVE AC, [XWD N,LOC] 
GOBSTR AC, 
error return 
normal return 

LOC: job number 

LOC+1: XWD proj no, prog no 

\-OC+2: SIXBIT/NAME/or-1 

LOC +3: 

LOC+4: Status bits 



MOVE AC, high-priority queue no. 
HPQ AC, 
error return 
normal return 

MOVSl AC, enable bits 
HRRI AC, sleep time 
HIBER AC, 
error return 
normal return 

MOVE AC, job no. 
WAKE AC, 
error return 
normal return 

MOVE AC, new proj. prog. no. 
CHGPPN AC, 
error return 
normal return 

MOVE AC, [XWD function, argu- 
ment] 

SETUUO AC, 
error return 
normal return 



Function 



Return physical name of de- 
vice obtained through generic 
INIT/OPEN or logical de- 
vice assignment (refer to 
Paragraph 4. 10.6). 

Return job number of con- 
trolling job (refer to Para- 
graph 5.9.4.5). 

Return next file structure 
name in an arbitrary job's 
search list (refer to Para- 
graph 6.2.9.9). 



> Reserved for the future. 

Place job in high priority 
scheduler's run queue (refer 
to Paragraph 3.8.5). 



Allow job to become dormant 
until the specified event 
occurs (refer to Paragraph 
3.1.4.2). 

Allow job to activate the 
specified dormant fob (refer 
to Paragraph 3.1.4.3). 

Change project-programmer 
number. Gives an error 
return if executed by a job 
already logged-in. 

Set system and fob para- 
meters (refer to Paragraph 
3.4.2). 



Reserved for the future. 
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CALU AC, 77 OTHUSR 



CALLI "^ 
Mnemonic 



CALU AC, 100 



CHKACC 



CALLI AC, 101 



DEVSIZ 



CALU AC, 102 



CALU AC, 103 



CALU AC, 104 



CALU AC, 105 



DAEMON 



JOBPEK 



ATTACH 



^"^ 



tt 



DAERN 



tt 



CALU AC, 106 FRCUUO 



vtt 
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MONITOR CALLS 



CALL 



OTHUSR AC, 
non-skip return 
skip return 
AC: = proj. prog. no. 

MOVE AC, [EXP LOC] 

CHKACC AC, 

error return 

normal return 

LOC: XWD action, protection 

LOC+1: directory proj-prog no. 

LOC+2: user proj-prog no. 

MOVE AC, [EXP LOC] 
DEVSIZ AC, 
error return 
normal return 
LOC: EXP STATUS 
LOC+1: SIXBIT/dev/ 

MOVE AC, [XWD + length, adr of 
arg. list] 
DAEMON AC, 
error return 
normal return 

MOVE AC, adr of org block 
JOBPEK AC, 
error return 
normal return 

MOVE AC, [XWD line no., job no.] 
ATTACH AC, 
error return 
normal return 

MOVE AC, [XWD + length, adr of 
org. list] 
DAERN AC, 
error return 
normal return 



MOVE AC, [XWD + length, adr of 
org. list] 
FRCUUO AC, 
error return 
normal return 



Funct 



ion 



Determine if another job is 
logged in with same project- 
programmer number (refer to 
Paragraph 3.6.2.4). 

Check user's access to the 
file specified (refer to 
Paragraph 6.2.9.6). 



Determine buffer size for the 
specified device (refer to 
Paragraph 4.10.4). 



Request DAEMON to per- 
form a specified task (refer 
to Paragraph 3.7). 



Read or write another job's 
core. Gives the error return 
if executed by a non-systet^- 
pri vi I eged program. 

Attach the job to the spec- 
ified TTY line number. 
Gives the error return if 
executed by a non -system - 
privileged program. 

Indicate that the request to 
the DAEMON program has 
been completed. Gives the 
en-or return if executed by 
a non-system-privileged 
program. 

Force a command for a job. 
Gives the error return if ex- 
ecuted by a non-system- 
privileged program. 
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CALLl 



CALLI AC, 107 



CALLI ' 
Mnemonic 



DEVLNM 



CALLI AC, 110 



PATH. 



CALLI AC, 111 



METER. 



CALU AC, 112 



CALLI AC, 113 



MTCHR. 



JBSET. 



CALLI AC, 114 



POKE. 
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CALL 



MOVE AC, [SIXBIT/dev/1 or 

MOVEl AC, channel no. 

MOVE AC+1, [SlXBIT/logical name/j 

DEVLNM AC, 

error return 

normal return 

MOVE AC, [XWD + length, adr. of 

argument list] 

PATH. AC, 

error return 

normal return 

ADR: N or SIX BIT/NAME/ 

ADR+1: Scan switch 

ADR+2: PPN 

ADR+3: SFD name 

ADR+4: SFD name 



MOVE AC, [XWD N, LOC] 

METER. AC, 

error return 

normal return 

LOC: function code 

LOC+1 : argument depends 

LOC+2: on function code used. 



LOC+N-1: 

MOVEI AC, channel no. or 
MOVE AC, [5IXBIT/dev/3 
MTCHR. AC, 
error return 
normal return 

MOVE AC, [2,, BLOCK] 

JBSET. AC, 

en"or return 

normal return 

BLOCK: 0,, job number 

BLOCK +1: function,, value 

MOVE AC, [3,, BLOCK] 
POKE. AC, 
error return 
normal return 
BLOCK: location 
BLOCK+1: old value 
BLOCK +2: new value 



Function 

Set a logical name for this 
specified device (refer to 
Paragraph 4.8.4). 



Read or modify the default 
directory path or read the 
current path of a file OPEN 
on a channel . Refer to 
Paragraph 6.2.9.1 . 



Provide performance analysis 
and metering of dynamic 
system variables. Refer to 
Paragraph 3.9. 



Return characteristics of the 
magnetic tape. Refer to 
Paragraph 5.5.3.2. 



Execute the specified 
function of SET DUO for a 
particular job. 



Alter the specified location 
in the Monitor. Refer to 
Paragraph 3.6.3.3. 
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CALLI 



CALLI^ 
Mnemonic 



CALLI AC, 115 



CALU AC, 116 



TRMNO. 



TRMOP. 



CALU AC, 117. 



CALL! AC, 120 



RESDV. 



UNLOK 



CALLI AC, 121 



CALLI AC, 122 



CALLI AC, 123 



DISK. 



DVRST. 



tt 



DVURS. 



tt 
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CALL and CALLI Monitor Operations 



CALL 



MOVE AC, job number 
TRMNO. AC, 
error return 
normal return 

MOVE AC, [XWD N, ADR] 
TRMOP. AC, 
error return 
normal return 
ADR: function code 
ADR+1: terminals's universal index 
Following arguments depend 
'. on function used. 

MOVE AC, channel no. 
RESDV. AC, 
error return 
normal return 

MOVSI AC, 1 
MOVSI AC,0 
HRRI AC, 1 
HRRI AC,0 
UNLOK. AC, 
error return 
normal return 

MOVE AC, [XWD function, ADR] 
DISK. AC, 
error return 
normal return 

MOVE AC, [SIXBIT/dev/] or 
MOVEI AC, channel no. 
DVRST. AC, 
error return 
normal return 

MOVE AC, CSIXBIT/dev/] or 
MOVEI AC, channel no. 
DVURS. AC, 
error return 
normal return 



Function 



Return number of the ter- 
minal currently controlling 
the specified job. Refer to 
Paragraph 5.10.5. 

Perform miscellaneous ter- 
minal functions. Refer to 
Paragraph 5. 10.6. 



Reset the specified channel 
Refer to Paragraph 4.8.2. 



Unlock a locked fob in core 
Refer to Paragraph 3.2.2.4. 



Set or read a disk or file 
system parameter (e.g., set 
the disk priority for a 
channel or the job). Refer 
to Paragraph 6.2.9.14. 

Restrict the specified device 
to a privileged job. 



Remove the restricted 
status of the specified 
device. 



The CALLI mnemonics are defined in a separate MACRO assembler table, 
an undefined OP CODE is found. If the symbol is found in the CALLI tab! 
had appeared in an appropriate OPDEF statement, that is 

RETURN : EXIT 
If EXIT is undefined, it will be assembled as though the program contained 

OPDEF EXIT [CALLI 12] 
This facility is available in MACRO V.43 and later. 



which is scanned whenever 
e, it is defined as though it 

the statement 
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■ 1 



ttjhis CALLI is a system-privileged UUO available only ^° ^^^'^^^ed 'n und- fl 23^ 

running with the JACCT bit set. Complete documentation for system -privileged UUOs appears 

Specifications section of the DECsystem-10 So ftware Notebooks. 

+ ^Ull CALLI's above CALLI 55 do not have a corresponding CALL with a SIXBIT argument. This is to 

save monitor table space. _^ ._ _ 

The customar U ollowed to oM his own CALL and CALLI colls to the monitor. A negative CALLI 
effective address (-2 or less) should be used to specify such customer-added operations. 

2 2 2.2 Suppression of Logical Device Names - Some system programs, e.g. , LOGOUT, require 
I>0 to specific physical devices regardless of the logical name assignments. Therefore for any CALLI , 
I if bit 19 (UU. PHS) in the effective address of the CALLI is not equal to bit 18, only phys.col names 
will be used; logical device assignments will be ignored. This suppression of logical device names 
ill be ignored. This suppression of logical device names is helpful, for example, when using the 
Its of the DEVNAM UUO where the physical name corresponding to a logical name is returned. 



w 
resu 



2 2 2.3 Restriction on Monitor UUOs in Reentrant User Programs - A number of restrictions on UUOs 
that involve a high segment prevent naive or malicious users from interferring with other users while 
sharing segments and minimize monitor overhead in handling two-segment programs. The basic rules 
are as follows: 

a. All UUOs can be executed from the low or high segment although some of their argu- 
ments cannot be in or refer to the high segment. 

b. No buffers, buffer headers, or dump-mode command lists may exist in the high segment 
for reading from or writing to any I/O device. 

c. No I/O is processed into or out of the high segment except via the SAVE and SSAVE 
commands. 

d No STATUS, CALL or CALLI UUO allows a store in the high segment. 

e' The effective address of the LOOKUP, ENTER, INPUT, OUTPUT, and RENAME UUOs 

cannot t in the high segment. If any ^le is violated, an address check error message 

is given. 

f . As a convenience in writing user programs, the monitor makes Vr'°'n-t'lrur.cl 
the INIT UUO can be executed from the high segment, although the '^^ > ' "9 ^^^q,'^,^'^^,^ _ 
sin the high segment. The monitor also allows the effective address of he CALL UUO 
which contains the SIXBIT monitor function name, and the effective "^^^^^^^^^^^^^^^^ 
UUO, which contains the status bits, device name, and buff er header addresses , m he 
high segment. The address of TTCALL 1 , and TTCALL 3, may be in the high segment for 
convenience in typing messages. 
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2.2.3 Operation Codes 100-127 (Unlmplemenfed Op Codes) 

Op code lOO(UJEN) Dismiss real-time interrupt from user mode 

(refer to Paragraph 3.8.4), 

Op codes 101-107 Monitor prints ?ILL INST. AT USER n and 

1^4-117 stops the lob. 

123 ' 

Op codes 110-1 13 These op codes are valid on the KIlO. If 

HaHI "'®'' °" ^^® ^^^^' ^^^ "monitor prints 

124-127 ?KI10 ONLY INST. AT USER n and stops 

the job. ^ 

2.2.4 Illegal Operation Codes 

TheeighH/Oins^ruotlons(e.a., DATAI) and JRST inst^Hons with bit 9 or 10= 1 (e g HALT 
JEN) ore interpreted by the nonitor a. illegal in^tr^tlons (refer to the System Reference Manual in 
the Sofh^ore Notebooks). The job is slopped and a question mork is printed im^diotely. A carriage 
return-line feed is then output, followed by on error message. For example, a DATAI instruction 
would produce the following: 

? 

? ILL INST AT USER addr 

2.2.5 Naming Conventions for Monitor Symbols 

The names of the monitor^s date base symbols contain dots or percent signs so that they can be made 
user-mode symbols without conflicting with previously-coded user programs. Data symbols can be 
divided into five classes: 

1) numbers 

2) masks 

3) UUO names 

4) GETTAB arguments 

5) error codes. 

Symbols defining numbers begin with a dot, followed by a two-letter prefix indicating the type of 
number, and end with a three-character obbreviati^ representing the specific number. Numbers are 
18-b,t quantities and include core addresses and function codes. The following ore examples of names 
of various numbers: 

. JBxxx Job Data Area 

. GTxxx GETTAB table numbers 

.RBxxx Extended arguments for LOOKUP, ENTER, RENAME 
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Names for masks start with a two-letter prefix Indicating the individual word, followed by a dot, and 
end with three characters representing the specific mask. Masks are 36-bit quantities and include b.ts 
and fields. The following are examples of names of masks: 

JP.xxx Privilege word bits 

JW.xxx WATCH word bits 
PC. XXX PC word bits 

Names for UUOs implemented ofter the 5.03 release of the monitor are five or less characters followed 
by a dot. For example, 

PATH. UUO to modify directory path 

TRMOP. UUO to perform terminal functions. 

Individual words within a GETTA8 table start with a percent sign, followed by two characters repre- 
senting the generic name of the table, and end with three characters Identifying the specific word. 
For example, 

%NSCAAX CORMAX word in the nonswapping data table. 

%CNSTS States word in the configuration table. 

Names of bytes and bits within a GETTAB word begin with two characters representing the word, 
followed by a percent sign, and end with three characters designating the specific byte. 

ST % DSK Byte representing disk system; contained in the states word. 

ST % SWP Byte indicating swapping system; contained in the states word. 

Error codes returned on a UUO error have names with the following pattern: two characters indicating 
the UUO, three characters designating the failure type, and a terminating percent sign. 

DM1LF% DAEMON error; Illegal function. 

RTDIU% RTTRP error; device in use. 

LKNLP% LOCK error; no locking privileges. 

Miany of the values useful in user programming are encoded in the parameter file C.MAC for the con- 
venience of writing and modifying programs. 
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CHAPTER 3 
NON-1/0 UUOS 



3.1 EXECUTION CONTROL 



3.1,1 Starting 



A user program may start another program only by using the RUN or GETSEG UUOs (refer to 
Paragraphs 3.3.1 and 3.3.2). A user at a terminal may start a program with the monitor commands 
RUN, START, CSTART, CONT, CCONT, DDT, and REENTER (refer to DECsystem- 10 Operating 
System Commands ). The starting address either appears as an argument of the command or is stored 
in the user's job data area (refer to Chapter 1). 

3.1.1.1 SETDDT AC, or CALLI AC, 2 - This UUO causes the contents of the AC to replace the 
DDT starting address, which is stored in the protected job data area location .JBDDT. The starting 
address is used by the monitor command, DDT. 

3.1.2 Stopping 

Any of the following procedures can stop a running program: 

a. One tC from the user's terminal if the user program is in a TTY input wait; otherwise, 
two iCs from the user's terminal (refer to DECsystem-10 Operating System Commands ); 

b. A monitor detected error; 

Co Program execution of HALT, CALL IS IXB IT/EXIT/], or CALL [SIX BIT/LOG OUT/]. 

3.1.2.1 Illegal Instructions (700-777, JRST 10, JRST 14) and Unimplemented OP Codes (101-127)- 
Illegal instructions trap to the monitor, stop the job, and print: 

?ILL INST. AT USER adr or ?KI ONLY INST. AT USER adr 

Refer to Paragraph 2.2.3 for an explanation of op codes 101-127. Note that the program cannot be 
continued by typing the CONT or CCONT commands. 
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3.1 .2.2 HALT or JRST 4 - The HALT instruction is an exception to the illegal instructions; it traps 
to the monitor, stops the job, and prints: 

? HALT AT USERadr 

where n is the location of the HALT instruction. If the HALT instruction is in location 41 and the 
program executed a user UUO (operation codes 001-037), the address in the error message is that 
of the user UUO instead of address 41 . 

However, the CONT and CCONT commands are still valid, and, if typed, will continue the program 
at the effective address of the HALT instruction. After a user pH-ogram HALT instruction followed 
by a START, DDT, CSTART, or REENTER command, . JBOPC contains the address of the HALT. 
To proceed at the address specified by the effective address, it is necessary for the user or his 
program to recompute the effective address of the HALT instruction and to use this address to start 
(refer to .JBOPC description. Table 1-1 in Paragraph 1 .2.1). HALT is not the instruction used to 
terminate a program (refer to Paragraph 3.1 .2.3). HALT is useful for indicating impossible error 
conditions. 

3,.l .2.3 EXIT AC, or CALLI AC, 12 - When the value of AC is zero, all ]/0 devices (including 
real-time devices) are RELEASed (refer to Paragraph 4.8.1); the job is unlocked from core; the user 
mode write protect bit (UWP) for the high segment is set; the APR iraps are reset to 0; the PC flags 
are cleared; and the job is stopped. If timesharing was stopped (refer to Paragraph 3.8.3), it is 
resumed. In other words, after releasing all I/O devices that close out all files, a RESET is done 
(refer to Pcragraph 4.1 .2). The carriage-return/line-feed is performed, and 

EXIT 
Is printed on the user's terminal, which is left in monitor mode. The CONT and CCONT commands 
cannot continue the program. 

I When the value of AC is n<xizero, the job is stopped, but devices are not RELEASed and a RESET is 
not done. Instead of printing EXIT, only a carriage-return and line-feed is performed, end a period 
is printed on the user's terminal. The CONT and CCONT commands may be used to continue the 
program. In other words, this form of EXIT does not affect the state of the job except to stop it and 

I return the terminal to monitor mode. Programs using EXIT 1, (MONRT.) as a substitute for EXIT 
(to eliminate the typing of EXIT) should RELEASE all devices first. 
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AP.REN 


18 


400000 


AP.POV 


19 


200000 


AP.ILM 


22 


20000 


AP.NXM 


23 


10000 


AP.PAR 


24 


4000 


AP.CLK 


26 


1000 


APoFOV 


29 


100 


AP.AOV 


32 


10 
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3.1.3 Trapping 

3.1 .3.1 APRENB AC, or CALLI AC, 16 - APR trapping allows a user to handle any and all traps 
that occur while his job is running on the central processor, including illegal memory references, 
non-existent memory references, pushdown list overflow, arithmetic overflow, floating-point over- 
flow, and clock flag. To enable for trapping, a APRENB AC, or CALLI AC, 16 is executed, where 
the AC contains the central processor flags to be tested on interrupts, as defined below: 

Name AC Bit Trap On 

Repetitive enable 
Pushdown overflow 
Memory protection violation 
Nonexistent memory flag 
Parity error 
Clock flag 

Floating-point overflow 
Arithmetic overflow 

When one of the specified conditions occurs while the central processor is in user mode, the state of 

the central processor is CONditioned Into (CONI) location, .JBCNI, and the PC is stored in location 

.JBTPC in the job data area (refer to Table 1-1 in Paragraph 1 .2ol). Then control is transferred to 

the user trap-answering routine specified by the contents of the right half of .JBAPR, after the 

arithmetic and floating-point overflow flags are cleared. (However, the job is stopped if the PC 

is equal to the first or second instruction in the user's trap routine.) The user program must set up 

location .JB APR before executing the APRENB UUO. To return control to his interrupted program, 

the user's trap-answering routine must execute a JRSTF @ . JBTPC which clears the bits that hove been 

processed and restores the state of the processor. 

The APRENB UUO normally enables traps for only one occurrence of any selected condition and must 
be re-issued after each condition of a trap. To disable this feature, set bit 18 to a 1 when executing 
the UUOo However, even with bit 18 = 1, clock interrupts must be re-enabled after each trap. 

If the user program does not enable traps, the monitor sets the PDP-10 processor to ignore arithmetic 
and floating-point overflow, but enables interrupts for the other error conditions in the list above. 
If the user program p-oduces such an error condition, the monitor stops the user job and prints one of 
the following appropriate messages: 

?PC OUT OF BOUNDS AT USER PC addr 

?ILL MEM REF AT USER PC addr 

? NON-EX MEM AT USER PC addr 

7PDLOV AT USER PCaddr 

?MEM PAR ERROR AT USER PC addr 

The CONT and CCONT commands will not succeed after such an error. 
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3,1.3.2 Error Intercepting -When certain conditions occur in the program, the monitor intercepts 
the condition and examines location . JBINT in the job data area. Depending on the contents of 
this location, control is either retained by the user program or is given to the monitor for action. If 
this location is zero, the job is stopped and the user and possibly the operator are notified by appro- 
priate messages, if any. If location .JBINT is non-zero, the contents is interpreted as the address 
of a block with the following format: 

LOCr XWD N, I NT LOG 
LOC+1: XWD BITS, CLASS 
LOC+2: 
LOC+3: 

where N is the number of words in the block (N >3). 

INTLOC is the location at which the program is to be restarted. 

BITS is a set of bits interpreted as follows: 

If bit 0= 1, an error message, if any, is not to be typed on the user's 
terminal or, in some cases, the operator's terminal. 

If bit = 0, an error message, if any, will be typed on the user's 
terminal and possibly the operator's terminal. 

CLASS is a set of bits interpreted as follows: 

For each type of error, CLASS has a specific bit. For a given error, the job will 
be interrupted if the appropriate bit is 1 and the content of LOC+2 is zero. The 
job will be stopped if either the appropriate bit is or the appropriate bit is 1 and 
the content of LOC+2 is not zero. By requiring LOC+2 to be zero, the possibility 
of a loop occurring is prevented. 

The monitor examines the CLASS bits and the contents of LOC+2 to determine if the job is to be 
stopped or interrupted on the particular error. If the job is interrupted, the following information 
is then stored in LOC+2 and LOC+3: 

LOC+2 Tlie last user PC word. 

LOC+3 RH= the channel number. 

LH = the error bit as defined in CLASS (see below). 

The job is then restarted at location INTLOC. 

The CLASS bits are defined as follows: 
De vice Error s 

Bit 35 (ER.IDV) represents device errors that can be corrected by human 
intervention. The appropriate message returned to the user is 

DEVICE XXX OPR zz ACTION REQUESTED 

where xxx is the dfjvice name, and zz is the number of the station at which the opera- 
tor is located. The operator receives the message 

%PROBLEM ON DEVICE xxx FOR JOB n 



This bit depends on FTOPRERR v/hich is normally off in the DECsystem-1040. 
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where xxx is the device name, and n is the number of the job that is stopped. When 
the operator has corrected the error, he starts the job with the JCONT command and 
the message 

CONTBYOPER 

appears on the user's terminal to signify that the error has been corrected. 



C Intercept 



,1 



Bit 34 (ER. ICC) indicates a 1C intercept. This intercept allows the user's program 
to process a 1C itself instead of allowing the job to automatically return to monitor 
level. If this bit is ], the job does not return to monitor level on two Cs (or on one 
1C if the job is in TTY input wait), but instead traps to the user's interrupt routine. 
There are no messages associated with this bit. When enabled for 1C, the program 
should normally exit immediately by releasing any special resources and issuing an 
EXIT UUO (MONRT. or CALLI 1, 12). . If the user types .CONT, the job continues. 



TITLE CONCIN — SAMPLE FOR CONTROL-C INTERCEPT 

;THIS ROUTINE SHOWS HOW TO ENABLE FOR A CONTROL-C INTERCEPT 
;AND HANDLE IT CORRECTLY. THE IDEA IS TO GET THE USER TO 
;.^NITOR LEVEL AS QUICKLY AS POSSIBLE. 



LOC 

EXP 
RELOC 



INT3LK: XWD 
XWD 
Z 
Z 



134 
INTBLK 



4,INTL0C 
0,2 



;SET POINTER IN .JBINT 
: TO THE INTERRUPT BLOCK 



; 4 WORDS LONG,, PLACE TO START 
;N0 MESSAGE CONTROL,, TYPE 2 <tC) 
; GETS LAST USER PC 
;LH GETS INTERRUPT TYPE 



J THE INTERRUPT ROUTINE STARTS HERE 



INTLOC: MOVEM 1, TEMPI 



HLRZ 


l,INTBLK+3 


CAIE 


1,2 


HALT 


• 




;R 


EXIT 


1, 


MOVE 


l,INTBLK+2 


EXCH 


1, TEMPI 


PUSH 


P,INTBLK+2 


SETZM 


lNTBLK+2 


POPJ 


P. 



TEMPI: 



;SAVE AC 1 

;GET REASON FOR INTERRUPT 

;SEE IF CONTROL-C 

; ERROR IF NOT 
;RELEASE ANY SPECIAL RESOURCES HERE 
BUT BE CAREFUL THAT THIS DOES NOT 
TAKE VERY LONG OR CAUSE A LOOP. 

; RETURN TO MONITOR 

;GET RETURN PC 

; RESTORE AC 

;SAVE RETURN ADDRESS 

;CLEAR INTERUPT TO ALLOW ANOTHER ONE 

; RETURN TO PROGRAM WHERE STOPPED 

; TEMPORARY 



Ul,.,.. 



This bit depends on FTCCIN which is normally off in the DECsystem-1040 
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The following example illustrates user C processing by a program which will not let users reach mon- 
itor level by mecms of a tC. 



LOC 
EXP 
RELOC 


134 
INTBLK 


INTBLK: XWD 
XWD 
Z 

z 


3, INTLOC 
0.2 


; IHE INTERRUPT 


ROUTINE 


INTLOC: SKIPL 
JRST 


RENFLA 
.+3 


SETZM 
JRST 


INTBLK+2 
REENRT 



SETOM RENSWH 

PUSH P, INTBLK+2 

SETZM INTBLK+2 

POPJ P, 



;SET UP .JBINT TO POINT TO 
: THE INTERRUPT BLOCK 



;3 WORDS LONG,, PLACE TO START 
;N0 MESSAGE CONTROL, , TYPE 2 ( rC) 
;GETS LAST USER PC 
;LH GETS INTERRUPT TYPE 



;0K TO FAKE A REENTER? 

;N0, CURRENT ROUTINE CANNOT BE 

; INTERRUPTED 

;YES, RE-ENABLE INTERRUPT AND GO 
; TO INTERRUPT ROUTINE 

SET FLAG TO SAY "REENTER AS SOON AS 
YOU CAN" 

GET LAST PC. PUSH/POP 

RE-ENABLE INTERRUPT 

GO BACK TO INTERRUPTED ROUTINE 
NOTE THAT IF A CONTROL-C IS 
TYPED AFTER THE SETZM, THE 
INTERRUPTS NEST. 



Off-line Disk Unit 



Bit 33 (ER.OFL) indicates a disk unit has dropped off-line. The operator is given the 
message 

UNIT XXX WENT OFF-LINE (FILE UNSAFE) 

PLEASE POWER DOWN AND THEN TURN IT ON AGAIN 

immediately and then once every minute. The user receives the message 

DSK IS OFF-LINE. WAITING FOR OPERATOR 
ACTION. TYPE tC TO GET A HUNG MESSAGE 
(IN 15 SECONDS). DONT TYPE ANYTHING TO WAIT 
FOR THE OPERATOR TO FIX THE DEVICE, 
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If the user has a system resource, he receives the additional message: 

THE SYSTEM WILL DO NO USEFUL WORK UNTIL 
THE DRIVE IS FIXED OR YOU TYPE 1C 

Full File Structure 

Bit 32 (ER.FUL) indicates that a file structure has filled up with data (i.e., there are 
no free blocks). There are no messages associated with this bit. 

Exhausted Disk Quota 

Bit 31 (ER.QEX) indicates that the user's disk quota has been exhausted. The user 
receives the message 

[EXCEEDING QUOTA file structure name] 

Exceeded Time Limit 

Bit 30^ (ER.TLX) indicates that the user's run time limit (as set by a previous 
SET TIME command) has been exceeded. This bit is used only by non-batch 
|obs. The user receives the message 
? TIME LIMIT EXCEEDED 

3.1.4 Suspending 

3.1 .4. 1 SLEEP AC, or CALLI AC, 31 - This UUO temporarily stops the job and continues it auto- 
matically after the elapsed real-time (in seconds) indicated by the contents of the AC. There is 

an implied maximum of approximately 68 sec (82 sec in 50-Hz countries) or 1 min. A program that 
requires a longer SLEEP or HIBER time should use the HIBER UUO with no clock request and then call 
DAEMON, via the .CLOCK function (refer to Paragraph 3.7.2), to wake it. 

3.1 .4.2 HIBER AC, or CALLI AC, 72^ - The HIBERNATE UUO allows a job to become dormant 
until a specified event occurs. The possible events that can wake a hibernating job are: 1) input 
activity from the user's TTY or any TTY INITed by this job (both line mode and character mode), 
2) PTY activity for any PTY currently INITed by this job, 3) the time-out of a specified amount 
of sleep time, or 4) the issuance of a WAKE UUO directed at this job either by some other job with 
wake-up rightsor by this job at interrupt level. 

The HIBERNATE UUO must contain in the left half of AC the wake-condition enable bits and in the 
right half the number of ms for which the job is to sleep before it is awakened. 



^This bit depends on FHLIM which is normally off in the DECsystem-1040. 
^This UUO depends on FTHIBWAK which is normally off in the DECsystem-1040. 
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The call is as follows: 

MOVSI AC, enable bits ;get HIBERNATE conditions 

HRRI AC, sleep time ;number of ms to sleep 

HIBER AC, ;or CALLI AC, 71 

error return 
normal return 

The HIBERNATE DUO enable condition codes are as follows: 

°il! Meaning 

18-35 Number of ms sleep time. It is rounded up to an even 

multiple of jiffies (maximum being 2 jiffies). Zero 

means no clock request (i.e., infinite sleep). 

15-17 WAKE UUO protection code: 

Bit 17 (HB.RWT)= 1, project codes must match. 
Bit 16 (HB.RWP)= 1, programmer codes must match. 
Bit 15 (W.RWJ) = 1, only this job can wake itself. 

13-14 Wake on TTY input activity: 

Bit 14 (l-B.RTC) = 1, wake on character ready. 
Bit 13 (HB.RTL) = 1, wake on line of input ready. 

12 (W.RPT) Wake on PTY activity since last HIBERNATE. 

(HB.SWP) Causes job to be swapped out immediately. 

An error return is given if the UUO is not implemented. The SLEEP UUO should be used in this case. 
A normal return is given after an enabled condition occurs. 

Jobs either logged-in as [1,2] or running with the JACCT bit on can wake any hibernating job regard- 
less of the protection code. This allows privileged programs, which are the only jobs that can wake 
certain system jobs, to be written. 

A RESET UUO always clears the protection code and wake-enable bits for the job. Therefore, until 
the first HIBERNATE UUO is called, there is no protection against wake-up commands from other 
jobs. To guarantee that no other job wakes the job, a WAKE UUO followed by a HIBERNATE UUO 
with the desired protection code should be executed. The WAKE UUO ensures that the first HIBER- 
NATE UUO always returns immediately, leaving the job with the correct protection code. 

3.1,4.3 WAKE AC, or CALLI AC, 73^ - The WAKE UUO allows one job to activate a dormant job 
when some event occurs. This feature can be used with Batch so that when a job wants a core dump 
taken, it can wake up a dump program. Also, real-time process control jobs can cause other process 
control jobs to run in response to a specific alarm condition. The WAKE UUO can be called for a 
RTTRP job running at interrupt level, thereby allowing a real-time job to wake its background portion 



This UUO depends on FTHIBWAK which is normally off in the DECsystem-1040. 
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quickly in order to respond to some real-time condition. (Refer to Paragraph 3.8.1 .2 for the 
restrictions on accumulators when using the RTTRP UUO at inten-upt level.) 

The call is as follows: 

MOVE AC, JOBNUM ;number of job to be awakened 

WAKE AC, ;or CALLI AC, 73 

error return 
normal return 

An error return is given if the proper wdke privileges are not specified. There is a wake bit associated 
with each job. If any of the enabled conditions specified in the last HIBERNATE UUO occurs, then 
the wake bit is set. The next time a HIBERNATE UUO is executed, the wake bit is cleared and the 
HIBERNATE UUO returns immediately. The wake bit eliminates the problem of a job going to sleep 
and rilissing any wake conditions. 

On q normal return, the job has been awcd<ened and has started at the location of the normal return 
of the HIBER UUO that caused it to become dormant. 

3.2 CORE CONTROL 

For various reasons, privileged jobs may desire to be locked in core so that they are never to be con- 
sidered for swapping or shuffling. Some examples of these j<^s are as follows: 

Real-time jobs These jobs require immediate access to the processor in response 

to an interrupt from an I/O device. 

Display jobs The display must be refreshed from a display buffer in the user's 

core area in order to keep the display picture flicker-free. 

Bateh Batch throughput may be enhanced by locking the Batch job 

controller in core. 

Performance analysis Jobs monitoring the activities of the system need to be locked 
in core so that they can be invoked quickly with low overhead 
in order to record activities of the monitor. 

3.2.1 Definitions 

In swapping and non-swapping systems, unlocked jobs can occupy only the physical core not occupied 
by locked jobs. Therefore, locked jobs and timesharing jobs contend with one another for physical 
core memory. In order to control this contention, the system manager is provided with a number of 
system parameters as descri bed below. 

Total User Core is the physical core that can be used for locked and unlocked jobs. This value is 
equal to total physical core minus the monitor size. 

CORMIN is the guaranteed amount of contiguous core that a single unlocked job can have. This value 
is a constant system parameter and is defined by the system manager at monitor generation time using 
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MONGEN. It can be changed at monitor startup time using the ONCE ONLY dialogue. This value 
ccHi range from to Total User Core. 

C ORMAX is the largest contiguous size that an unlocked job can be. It is a time-varying system 
parameter that is reduced from its initial setting as jobs are locked in core. In order to satisfy the 
guaranteed size of CORMIN, the monitor never allows a job to be locked in core if this action would 
result in CORMAX becoming less than CORMIN. The initial setting of CORAAAX is defined at monitor 
generation time using MONGEN and can be changed at monitor startup time using the ONCE ONLY 
dialogue. CORMAX can range from CORMIN to Total User Core. A guaranteed amount of core 
available for locked jobs can be made by setting the initial value of CORMAX to less than Total User 
Core. 

3.2.2 LOCK AC, or CALLI AC, 60^ 

This UUO provides a mechanism for locking jobs in user memory. The user may specify if the high 
segment, low segment, or both segments are to be locked, and whether the core is to be physically 
contiguous. Note that on KAlO-based systerm, core is always allocated contiguously, and that the 
job may be moved to an extremity of user core before it is locked. 

A job may be locked in core if all of the following are true: 

a. The job has the LOCK privilege (set from the accounting file ACCT.SYS by LOGIN). 

b. The job, when locked, would not prevent cnother job from expanding to the guaranteed 
limit, CORMIN. 

c. The job, when locked, would not prevent an existing job from running. Note that 
unlocked jobs can exceed CORMIN. 

d. The job when mapped, if specifying exec mappir>g, would not exceed the maximum 
amount of exec virtual address space available for locking (KllOonly). 



The call is: 



MOVE AC, [XWD high seg. code, low seg. code] 

LOCK AC ;or CALLI AC, 60 

error return ;AC contains an error code 

normal return 



The segment codes are a series of bits which specify the way in which the high segment (LH code) 
and the low segment (RH code) are to be locked. The order and position of the bits in the left half 
correspond to the order and position of the bits in the right half; that is, to obtain the bit number for 
the high segment, subtract 18 from the corresponding bit for the low segment. The bits are shown 

below. 



This UUO depends on FTLOCK which is normally off in the DEC system -1040. 
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Bit 17 (high segment) 
Bft 35 (low segment) 



Bit 16 (high segment) 
Bit 34 (low segment) 



Bit 15 (high segment) 
Bit 33 (low segment) 



If 1, lock the segment in the manner indicated by 
the following bits. 

If 0, do not lock the segment; the following bits 
are ignored. 

If 0, map contiguously in the exec virtual memory 
(always implied on the KAIO). This causes the 
segment to be added to the exec virtual address 
space so that it can be executed in exec mode. For 
example, this is required when exec mode real-time 
trapping (RTTRP) is used On the KIlO;, the amount 
of exec virtual address space used by locked jobs 
is a limited resource with a defined maximum per 
processor. If mapping the segment would cause the 
maximum to be exceeded, the LKNEM% error 
return is given. The maximum amount available can 
be obtained from the CPU variable GETTAB table 
for each processor (GETTAB word %CVEVM). The 
current amount used can also be obtained from the 
table (%CVEVU). 
If 1, do not map in exec virtual memory. 

If 0, lock in contiguous physical memory locations 
(always implied on the KAIO). This causes the 
segment to be moved and remapped, if necessary, 
so that its physical core is contiguous. On the 
KAIO system, the segment is also moved to one end 
of user core in order to minimize fragmentation of 
memory. 

If 1, do not attempt physical contiguity. 

If the user requests a segment to be locked in contiguous physical memory, the monitor attempts to 
lock the segment as low in physical memory as possible. When the segment is locked below 1 12K, 
physical and virtual contiguity are equivalent, and thus in this case, virtual contiguity does not 
require the exec virtual memory resource to achieve contiguity. 

On a KAlO-based system, physical memory is always allocated contiguously and user segments are 
directly addressable in exec mode, and therefore, bit codes 1,3,5 and 7 are synonomous. 

The setting of bits 33 and 34 (bits 15 and 16) is conpatible with the implementation of the LOCK 
UUO on a KAlO-based system. That is, code 1 is the most restrictive, so that a program coded for 
the KAIO system that implicitly uses these properties will also run on the KIIO system. Applications 
that do not require all properties can add the appropriate bits to the LOCK UUO's calling sequence. 

On a normal return, the job is locked in core. If there is a high segment, the LH of AC contains its 
absolute address in units of pages (one page is 512 words). The value can be converted to a word 
address by shifting it left nine bits. If there is no high segment, the LH of AC contains zero. The 
RH of AC contains the absolute address of the low segment, shifted right nine bits. 
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On an error return, the job is not locked in core and AC either is unchanged or contains an error 
code. The AC is unchanged when the LOCK UUO is executed in monitors previous to the implemen- 
tation of the UUO. An error code indicates the condition that prevented the job From being locked. 
The error codes are as follows: 

En-or Code Name Explanation 

LKNIS% The UUO is not included in this system because it has 

not been defined with MONGEN or because the appro- 
priate feature test switch is off. 

1 LKNLP% The job does not have locking privileges, or RTTRP 

privileges, if required. 

2 LKNCA% If the job were locked in core, it would not be possible to 

run the largest existing non-locked job. (Applies only to 
swapping systems.) 

3 LKNCM% If the job were locked in core, it would not be possible to 

meet the guaranteed largest size for an unlocked job, that 
is, CORMAX would be less than CORMIN. 

4 LKNEM% The mode of locking requested exec virtual memory mapping 

but the allowable amount of exec mapping has been exhausted, 

NOTE 

The CORE UUO may be given for the high segment of a locked 
job only if it is removing the high segment from the addressing 
space. When tlie segment is locked in core, the CORE UUO and 
the CORE command with a non-zero argument cannot be satisfied 
and, therefore, always give an error return. The program should 
determine the amount of core needed for the execution and request 
this amount before executing the LOCK UUO. 

Although memory fragmentation is minimized byboth the LOCK UUO and the shuffler, the locking 
algorithm always allows jc^ locking, even though severe fragmentation may take place, as long as 

1) all existing jobs can continue to run, and 

2) at least CORMIN is available as a contiguous space (see Figure 3-1 E). 

Therefore, it is important that system manc^ers use caution when granting locking privilegeso The 
following are guidelines for minimizing fragmentation when using the LOCK UUO. 

3.2.2.1 KAIO Systems - The guidelines for KAIO systems are: 

a. There is no memor/ fragmentation if two jobs or less are locked in core. 

b. There is no fragmentation if the locked jobs do not relinquish their locked status 
(i.e., no job terminates that has issued a LOCK UUO). In general, jobs with 
locking privileges should be production jobs. 
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c. If a job issuing a LOCK DUO is to be debugged and production jobs with locking 
privileges are to be run, the job to be debugged should be initiated and locked in 
core first, since it will be locked at the top of core. Then, the production jobs 
should be initiated since they will all be locked at the bottom of core. This pro- 
cedure reserves the space at the top of core for the job being debugged and 
guarantees that there is no fragmentation as it locks and unlocks. 

d. With a suitable setting of CORMIN and the initial setting of CORMAX in relation 
to Total User Core, the system manager can establish a policy which guarantees 

1) a maximum size for any unlocked job (CORMIN), 

2) a minimum amount of total lockable core for all jobs (Total User Core - 
CORMAX), and 

3) the amount of core which locked and unlocked \dbs can contend for on a 
first-come -first-serve basis (Total User Core - initial CORMAX + CORMIN). 

Z, 1,1,1 Core Allocation Resource - Because routines that lock jobs in core use the swapping and 
core allocation routines, they are considered a sharable resource. This resource is the semipermanent 
core allocation resource (mnemonic=C A). When a job issues a LOCK UUO and the system is currently 
engaged in executing a LOCK UUO for another job, the job enters the queue associated with the core 
allocation resource. Because a job may share a queue with other jobs and because swapping and 
shuffling may be required to position the job to where it is to be locked, the actual execution time 
needed to complete the process of locking a job might be on the order of seconds. 

When it has been established that a job can be locked, the low segment number and the high segment 
number (if any) are stored as flags to activate the locking routines when the swapper md shuffler are 
idle. The ideal position for the locked job is also stored as a goal for the locking routines. In KAIO 
swapping systems, the ideal position is always achieved to guarantee minimum fragmentation. In 
nonswapping systems, minimum fragmentation is achieved only if the ideal position does not contain 
an active segment (see Figure 3-1). 

In swapping systems, after the job is locked in core, the locking routine determines the size of the 
new largest contiguous region available to unlocked jobs. This value will be greater than or equal 
to CORMIN. If this region is less than the old value of CORMAX, then CORAAAX is set equal to 
the size of the new reduced region . Otherwise, CORAAAX remains set to its old value. 

3o2o2.3 UNLOK. AC, or CALLI AC, 120 - This UUO provides a mechanism for d job to unlock 
itself without doing a RESET UUO. The user can specify if one or both segment are to be unlocked. 
The call is: 

MOVSI AC, 1 ;if high segment is to be unlocked 

MOVSI AC, ;if no high segment, or if high segment 

;is not to be unlocked 

HRRI AC, 1 ;if low segment is to be unlocked. 

HRRI AC, ;if low segment is not to be unlocked. 

UNLOK. AC, ;or CALLI AC, 120 
error return 
normal return 

1 ' 

This UUO depends on FTLOCK which is normally off in the DECsystem-1040. 
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Figure 3-1 Locking Jd)s In Core on KAIO Systems 
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Figure 3-1 Locking Jobs In Core on KAIO Systerrts (Cont) 
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Figure 3-1 Locking Jobs In Core on KAIO Systems (Cont) 

An error return is given if the UUO is not implemented. If this is the case, a job can relinquish its 
locked status when either the user program executes an EXIT or RESET UUO, or the monitor performs 
an implicit RESET for the user. Implicit RESETS occur when 

a. The user program issues a RUN UUO, or 

b. The user types any of the following monitor commands: R, RUN, GET, SAVE, 
SSAVE, CORE 0, and any system program- in vdking command. 

NOTE 
If several jobs are sharing a locked high segment, the 
high segment is unlocked only when the SN%LOK bit is 
turned off for all jobs sharing the segment (i«e., when all 
jdas which executed the LOCK UUO have performed the 
unlock function ) (refer to GETTAB table 14). 

On a normal return, the segment (or job) is unlocked and becomes a candidate for swqsping and 
shuffling. Any meter points (METER. UUO) ere deactivated end, if the low segment is unlocked, any 
real-time devices are RESET, CORMAX is increased to reflect the new size of the largest contiguous 
region available to unlocked jobs. However, CORMAX is never set to a greater value than its initial 
setting . 
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3.2.3 CORE AC, or CALLI AC, n 

This UUO provides a user program with the ability to expand and contract its core size as its memory 
requirements change. To allocate core in either or both segments, the left half of AC is used to 
specify the highest user address to be assigned to the high segment and the right half is used to specify 
the highest user address in the low segment. The monitor will assign the smallest amount of core which 
will satisfy the request. If the left half of AC contains 0, the high segment core assignment is not 
changed. If the left half of AC is non-zero and is either less than 400000 or the length of the low 
segment, whichever, is greater, the high segment is eliminated. If this is executed from the high seg- 
ment, an illegal memory error message is printed when the monitor attempts to return control to the 
illegal address. 

A RH of leaves the low segment core assignment unaffected. The monitor clears new core before 
assigning it to the user; therefore, privacy of information is ensured. 

The error return is given if: 

1) The LH is greater than or equal to 400000 and the system does not have a 
two-segment capability. 

2) The LH is greater than or equal to 400000 and the user has been meddling 
without write access privileges (refer to Paragraph 6.2.3). 

3) The LH and the RH are both zero. 

In swapping systems, this programmed operator returns the maximum number of IK core blocks (all of 
core minus the monitor, unless an installation chooses to restrict the amount of core) available to the 
user. By restricting the amount of core available to users, the number of jobs in core simultaneously 
is increased. In nonswapping systems, the number of free and dormant IK blocks is returned; therefore, 
the CORE UUO and the CORE command return the same information. 

For compatibility, the KIlO also returns the number of IK blocks available even though core is allo- 
cated in 512-word pages. The value returned is truncated to the nearest multiple of IK (e.g., if 21 
pages are available, the value returned in lOK). If it is necessary to obtain the exact amount of core 
available in units of pages, the user can examine the monitor location CORMAX (in GETTAB table 
12) with the GETTAB UUO (refer to Paragraph 3.6.3.4). CORMAX is the maximum number of words 
available to the user and thus can be converted to either pages or K. 



The call is: 



MOVE AC [XWD HIGH ADR or 0, LOW ADDR or 0] , . ,^ ,, , 

CORE AC, ;orCALLIAC, II 

error return 
normal return 
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The CORE UUO re -assigns the low segment (if RH is non-zero) and then re -assigns the high segment 
(if LH is non-zero). If the sum of the new low segment and the old high segment exceeds the maximum 
amount of core allowed to a user, the error return is given, the core assignment is unchanged, and the 
maximum core available to the user for high and low segments (in IK blocks) is returned in the AC. 
In a nonswapping system, the number of free and dormant IK blocks is returned. 

If the sum of the new low segment and the new high segment exceeds the maximum amount of core 
allowed to a user, the error return is given, the new low segment is assigned, the old high segment 
remains, and the maximum core available to the user in IK blocks is returned in the AC. Therefore, 
to increase the low segment and decrease the high segment at the same time, two separate CORE 
UUOs should be used to reduce the chances of exceeding the maximum size allowed to a user job. 
If the new low segment extends beyond 377777, the high segment shifts up into the virtual addressing 
space instead of being overlaid. If a long low segment is shortened to 377777 or less, the high seg- 
ment shifts from the virtual addressing space to 400000 instead of growing longer or remaining where 
it was. If the high segment is a program, it does not execute properly after a shift unless it is a self- 
relocating program in which all transfer instructions are indexed. 

If the high segment is eliminated by a CORE UUO, a subsequent CORE UUO, in which the LH is 
greater than 400000, will create a new, nonsharable segment rather than re-establishing the old high 
segment. This segment becomes sharable after it has been: 

a. Given an extension .SHR. 

b„ Written onto the storage device. 

c. Closed so that a directory entry is made. 

d. Initialized from the storage device by GET, R, or RUN commands or RUN or GETSEG 
UUOs. 

Tfie loader and the SAVE and GET commands use the above sequence to create and initialize new 
sharable segments^ 

A user program which expands core should compare its highest desired address with its highest legal 
address obtained from the Job Data Area location JBREL (refer to Chapter 1). If the desired address 
is greater than the highest legal address, the program should execute a CORE UUO for the new desired 
address (not for the highest old legal address plus 512 or 1024). The monitor then updates .JBREL by 
the number of words in its basic core allocation unit (i.e., 1024 words on the KAIO processor or 512 
words on the KIIO processor). Subsequent compares of the desired address and the highest legal address 
do not cause a CORE UUO until the next increase of core is required. If used this way, a CORE 
UUO will execute on both the KAIO and KIIO processors and will require less monitor CPU time 
because the number of CORE UUOs needed will be minimized. 

The following example illustrates the method for obtaining core only when needed. 
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SUBROUTINE TO GET CORE ONLY WHEN NEEDED 
CALL: MOVE Tl, HIGHEST DESIRED ADDRESS 

PUSHJ P, CHKCOR 

RETURN HERE UNLESS NO MORE CORE 



^: CAMLE 


T1,.JBREL## 


POPJ 


P, 


CORE 


Tl, 


JRST 


ERROR 


POPJ 


P, 



; GREATER THAN HIGHEST LEGAL ADDRESS? 
;N0, PRESENT CORE BIG ENOUGH. 
;YES, GET NEXT INCREMENT OF CORE. 
; NOT AVAILABLE. 
;NEXT increment ASSIGNED. 



3.2.4 SETUWP AC, or CALLI AC, 36 



This UUO allows a user program to set or clear the hardware user-mode write protect bit and to obtain 
the previous setting. It must be used if a user program is to modify the high segment. 
The call is: 

SETUV\^P AC, ;OR CALLI AC, 36 

error return 
normal return 

If the system has a two-register capability, the normal return will be given unless the user has been 
meddling without write privileges, in which case an error return will be given. A normal return is 
given whether or not the program has a high segment, because the reentrant software is designed to 
allow users to write programs for two-register machines, which will run under one-register machines. 
Compatibility of source and relocatcfole binary files is, therefore, maintained between one-register 
and two-register machines. 

If the system has a one-register capability, the error return (bit 35 of AC=0) is given. This error return 
allows the user program to find out whether or not the system has a two-segment capability. The user 
program specifies the setting of the user-mode write protect bit in bit 35 of AC (write protect = 1, 
write privileges = 0). The previous setting of the user-mode write protect bit is returned in bit 35 
of AC, so that any user subroutine can preserve the previous setting before changing it. Therefore, 
nested user subroutines, which either set or clear the bit, can be written, provided the subroutines 
save the previous value of the bit and restore it on returning to its caller, 

3.3 SEGMENT CONTROL 

3.3.1 RUN AC, or CALLI AC, 35 

This UUO has been implemented so that programs eon transfer control to one another. Both the low 
and high segments of the user's addressing space are replaced with the program being called. 

The call is: 

MOVSI AC, starting address increment 
HRRI AC, adr of six-word argument block 
RUN AC, or CALLI AC, 35 

error return (unless HALT in LH) 
[normal return is not here, but to start- 
ing address plus increment of new program] 
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The arguments contained in the six-word block are: 

E: SIXBIT/logical device name/ 

SIXBIT/filename/ ;for either or both high and low files 

SlXBIT/ext. for low file/ ;if LH= 0, .LOW is assumed if high 

segment exists, .SAV is assumed if 
high segment does not exist. 



XWD proj. no., prog. no. ;if = 0, use current user's proj, prog 

XWD 0, optional core ;RH = new highest user address to be 

assignment assigned to low segment. 

LH is ignored rather than setting high 
segment. 

A user program usually will specify only the first two words and set the others to 0. The RUN UUO 
destroys the contents of all of the user's ACs and releases all the user's I/O channels; therefore, argu- 
ments or devices cannot be passed to the next program. 

The RUN UUO to certain system programs (e.g., LOGIN, LOGOUT) automatically sets the approp- 
riate privileged bits (JACCT and J LOG). These bits are not set (ot are turned off if they were set) 
for programs that are not privileged programs from device SYS or for programs whose starting address 
offset is greater than 1 . Assigning a device as SYS does not cause these bits to be set. 

The RUN UUO clears all of core. However, programs should not count on this action, and must still 
initialize core to the desired value to allow programs to be restarted by a tC, START sequence with- 
out having to do I/O. 

Programs on the system library should be called by using device SYS with a zero project -prog rammer 
number instead of device DSK with the project-programmer number [1, 4]. The extension should also 
be so that the calling user program does not need to know if the called system program is reentrant 
or not. 

The LH of AC is added to and stored in the starting address (.JBSA) of the new program before control 
is transferred to it. The command 1C followed by the START command restarts the program at the lo- 
cation specified by the RUN UUO, so that the user can start the current system program over again. 

The user is considered to be meddling with the program (refer to Paragraph 3.3.5) if the LH of AC is 
not or ] unless the program being run is execute-only for this job. In this case, the offset is treated 
asO. 

Programs accept commcaids from a terminal or a file, depending on how they were started, due to 
control by the program calling the RUN UUO. The following convention is used with all of DEC's 
standard system programs: in LH of AC means type an asterisk and accept commands from the terminal 
A 1 means accept commands from a command file, if it exists; if not, type an asterisk and accept 
commands from the terminal. The convention for naming system program command files is that 
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the filename be of the form 

###III.TMP 

where III ore the first three (or fewer if three do not exist) characters of the name of the program 

doing the LOOKUP, and ### is the decimal character expansion (with leading zeroes) of the binary 

|ob number. The job number is included to allow a user to run two or more jobs under the same 

project-programmer number. For example, 

009PIP. TMP 
039MAC.TMP 

Decimal numbers are used so that a user listing his directory can see the same number as the PJOB 

command types. These command files are temporary and may, therefore, be deleted by the KJOB 

program (refer to KJOB command and Appendix C In DECsystem-10 Operating System Commands ). 

At times it is necessary to remember the arguments that a user typed in to invoke a program (i.e, the 

arguments on a GET or RUN command). For example, the COBOL program needs these arguments 

in order to GETSEG the next overlay from the same place. In all monitors, when the program is 

first started, this information can be obtained from the following accumulators: 

ACO (.SGNAM) contains the filename. 

AC7 (.SGPPN) contains the directory name. 

ACn (.SGDEV) contains the device name. 

AC17 (.SGLOW) contains the extension of the low segment. 

Note that the starting address should be changed by the program so that a C, START sequence will 
not destroy the remembered arguments in the ACs. This information should not be used when desiring 
to save the current segment name (GETTAB should be used in this case), but rather when obtaining 
the call arguments before calling the next segment. 

The RUN UUO can give an en-or return with an error code in AC if any errors are detected; thus, the 
user program may attempt to recover from the error and/or give the user a more informative message 
on how to proceed. Some user programs do not go to the bother of including error recovery code. 

The monitor detects this and does not give an error return if the LH of the error return location Is a 
HALT instruction. If this is the case, the monitor simply prints its standard error message for that type 
of error and returns the user's terminal to monitor mode. This optional en-or recovery procedure also 
allows a user program to analyze the en-or code received and then execute a second RUN UUO with 
a HALT if the error code indicates on error for which the monitor message is sufficiently informative or 
one from which the user program cannot recover. 

The error codes are an extension of the LOOKUP, ENTER, and RENAME UUO error codes and are 
defined in the S.MAC monitor file. Refer to Appendix E for an explanation of the error codes. 
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The rtonitor does not attempt on error return to a user program after the high or low segment containing 
the RUN DUO has been overlaid. The UUO should be placed in the low segment in case the error 
is discovered after the high segment has been released. 

To successfully program the RUN UUO for all size systems and for all system programs with a size that 
is not known at the time the RUN UUO is coded, it is necessary to understand the sequence of opera- 
tions the RUN UUO initiates. Assume that the job executing the RUN UUO has both a low and a high 
segment. (It can be executed from either segment; however, fewer errors con be returned to the user 
if it is executed from the high scjgment.) 

The sequence of operations for the RUN UUO is as follows: 

1 . Does a high segment already exist with desired narro? 
If yes, go to 30o 

INIT and LOOKUP filename .SHR. If not found, go to 10. 
Read high file info top of low segment by extending it. (Here the old segment 
and new high segment and old high segment together may not exceed the maxi- 
mum user core legally available to this job at the time of the UUO nor may it 
cause the total amount of virtual core assigned to all users to exceed the size 
of the swapping space . ) 

REMAP the top of low segment replacing old high segment in logical addressing 
space. 

If high segment is shardble (.SHR) store its name so others can share it. 
Always go to 40 or return to user if GETSEG UUO. 

K). LOOKUP filename . HGH. If not found, go to 41 or error return to user if 
GETSEG UUO. 

Read high file info fop of low segment by extending it. (The old low segment 
and new high segment and old high segment together may not exceed the maxi- 
mum user core legally available to this job at the time of the UUO nor may it 
cause the total amount of virtual core assigned to all users to exceed the size 
of the swapping space.) 

Check for V'O errors. If any, enror return to user unless HALT in LH of return. 
Go to 41 . 

30. Remove old high segment, if any, from logical addressing space. 

Place the sharable segment in user's logical addressing space. Go to 40 or re- 
turn to user if GETSEG UUO. 

35. Remove old high segment, if any, from logical addressing space. 
(Go to 41). 

40. Copy vestigial job data area into job data area. 
Does the new high segment have a low file 
(LHof .JBCOR >137)? 

If not, go to 45. 

41. LOOKUP filename .SAV or .LOW or user specified extension. Error if not 
found. Return to user if there is no HALT in LH of error return, provided that 
if the CALL is from the high segment, it is still the original high segment and 
has not been removed from the user's addressing space. Otherwise, the monitor 
prints one of the following error messages: 
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? NOT A SAVE FILE 

? filename .SAV NOT FOUND 

7TRANSMISSION ERROR 

? LOOKUP FAILURE n 

?nK OF CORE NEEDED 

?NO START ADR 

and stops the job. 

Reassign low segment core according to size of file or user specified core argu- 
ment, whichever is larger. Previous low segment is overlaid. Read low file 
into beginning of low segment. Check for I/O errors. If there is an error print 
error message and do not return to user„ If there are no errors, perform START. 

45, Reassign low segment core according to larger of user's core argument or argument 
when file saved (RH of .JBCOR). 

NOTE 
To be guaranteed of handling the largest number of errors, 
the cautious user should remove his high segment from high 
logical addressing space (use CORE UUO with a one in LH 
of AC). The error handling code should be put in the low 
segment along with the RUN UUO and the size of the low 
segment reduced to IK. A better idea would be to have 
the error handling code written once and put in a seldom 
used (probably nonsharable) high segment, which could be 
gotten in high segment using GETSEG UUO (see below) 
when an error return occurs to low segment on a RUN UUO. 

3.3.2 GETSEG AC, or CALLI AC, 40 

This UUO has been implemented so that a high segment can be initialized from a file or shared segment 
without affecting the low segment. It is used for shared data segments, shared program overlays, and 
run-time routines such as FORTRAN or COBOL object time systems. This programmed operator works 
exactly like the RUN UUO with the following exceptions: 

a. No attempt is made to read a low file. 

b. The accumulators are not preserved. The only change made to JOBDAT is to set 
the left half of . JBHRL to (a SAVE command then saves all of the high segment) 
and the right half to the highest legal user address. 

c. ff an error occurs, control is returned to the location of the error return, unless the 
left half of the location contains a HALT instruction. 

d. On a normal return, the control is returned to two locations following the UUO, whether 
it is called from the low or high segment. It should be called from the low segment unless 
the normal return coincides with the starting address of the new high segment. 

e. User channels 1 through 17 are not released so the GETSEG UUO can be used for pro- 
grarn overlays, such as the COBOL compiler. Channel is released because it is used 
by the UUO. 
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f. .JBSA and .JBREN are zeroed if they point to a high segment that is being removed. 
This produces the message: 
?NO START ADDRESS 
if a START or REENTER command is given.. 

Refer to steps 1 through 30 of the RUN UUO description (Paragraph 3.3. 1) for details of GETSEG 
UUO operation. 

3.3o3 REMAP AC, or CALL! AC, 37 

This UUO takes the top part of a low segment and remaps it into the high segment. The previous high 

segment (if any) will be removed from the user's addressing space. The new low segment will be the 

previous low segment minus the amount remapped. 

The call is: 

MOVEI AC, desired highest adr in low segment 

REMAP AC, ;o'' CALLI AC, 37 

error return 

normal return 

The monitor rounds up the address to the nearest core allocation unit of either 1024^^ (2000g) words 
on KAlO-based systems or 512^^ (lOOOg) words on KllO-based systems. If the argument exceeds the 
length of the low segment, remapping will not take place, the high segment will remain unchanged 
in the user's addressing space, and the error return will be taken. The error return will also be taken 
if the system does not have a two-register capobility. The content of AC is unchanged. The content 
of . JBREL (refer to Paragraph U2. 1) is set to the new highest legal user address in the low segment. 
The LH of .JBHRL is set to (a SAVE command then saves all of the high segment) and the RH is set 
to the highest legal user address in the high segment (401777 or greater or 0). The hardware reloca- 
tion will be changed, and the user-mode write protect bit will be set. 

This UUO is used by the LOADER to load reentrant programs, which make use of all of physical core. 
Otherwise, the LOADER might exceed core in assigning additional core and moving the data from the 
IcAv to the high segment with a BLT instruction. The GET command also uses this UUO to perform 
I/O into the low segment instead of the high segment. 

3,3 o4 Testing for Sharable High Segments 

Occasionally, it is desirable for a program to determine whether its high segment is sharable. If the 

high segment is sharable, the program may decide not to modify itself. The following code tests 

the high segment whether or not 1) the system has a high segment capability or 2) the job has a high 

segment. 
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HRROI T, .GTSGN ;see If high segment is sharable 

GETTAB T, ;iook at monitor oGTSGN table 

JRST .+2 ;table or UUO not present 

TLNN T, (SN%SHR) ;is sharable bit on ? 

JRST NOTSHR ;no, go ahead and modify here 

;if high segment is sharable. 

3.3.5 Modifying Shared Segments and Meddling 

A high segment is usually write-protected, but it is possible for a user program to turn off the user 
write-protect bit or to increase or decrease a shared segment's core assignment by using the SETUWP 
or CORE UUO. These UUOs are legal from the high or low segment if the sharable segment has not 
been "meddled" with, unless the user has write privileges for the file that initialized the high segment. 
Even the malicious user can have the privilege of running such a program, although he does not have 
the access rights to modify the file used to initialize the sharable segment. 

Meddling is defined as any of the following, even if the user has privileges to write the file which 
initialized the sharable segment. 

a. START or CSTART commands with an argument. 

b. DEPOSIT command in the low or high segment. 

c. RUN UUO with anything other than a or 1 in LH of AC as a starting address increment. 

d. GETSEG UUO. 

It is not considered meddling to perform any of the above commands or UUOs with a nonsharable pro- 
gram. It is never considered meddling to type C followed by START (without an argument), CO^NT, 
CCONT, CSTART (without an argument), REENTER^ DDT, SAVE, or E command. 

When a sharable program is meddled with, the monitor sets the meddle bit for the user. An error return 
is given when the clearing of the user write-protect bit is attempted with the SETUWP UUO or when 
the reassignment of core for the high segment (except to remove it completely) is attempted with the 
CORE UUO. An attempt to modify the high segment with the DEPOSIT command causes the message 
OUT OF BOUNDS 

to be printed. If the user write-protect bit was not set when the user meddled, it will be set to pro- 
tect the high segment in case it is being shared. The command and the two UUOs are allowed in spite 
of meddling, if the user has the access privileges to write the file which initialized the high segment. 

A privileged programmer is able to supersede a sharable program, which is in the process of being 
shared by a number of users. When a successful CLOSE, OUTPUT, or RENAME UUO is executed for 
a file with the same directory name and filename (previous name if the RENAME UUO is used) as the 
segment being shared, the name of the segment is set to 0. New users do not share the older version, 
but they do share the newer version. This requires the monitor to read the newly created file only 
once to initialize it. The monitor deletes the older version when all users are finished sharing it. 
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Users with access privileges are able to write programs that access sharable data segments via the 
GETSEG UUO (which is meddling) and then turn off the user write-protect bit using SETUWP UUO. 
With DEC tape, write privileges exist if it is assigned to the job (cannot be a system tope) or is not 
assigned to any job and is not a system tape. 

When control can be transferred only to a small number of entry points (two), which the shared program 
is prepared to handle, then the shared program can do anything it has the privileges to do, although 
the person running the program does not have these privileges. 

The ASSIGN (and the DEASSIGN, DISMOUNTAEMOV, FINISH, KJOB commands if the device was 
previously assigned by console) command clears all shared segment names currently in use, which were 
initialized for the device, if the device is removable (DTA, MTA). Otherwise, new users could con- 
tinue to share the old segment indefinitely, even if a new version were mounted on the device. 
Therefore, it is possible to update the library during regular timesharing, if the programmer has 
access privi leges » 

3.4 PROGRAM AND PROFILE IDENTIFICATION 

3.4.1 SETNAMAC, orCALLI AC, 43 

This UUO is used by the LOADER. The content of AC contains a left-justified SIXBIT program name, 
which is stored in a monitor job table. The information in the table is used by the SYSTAT program 
(refer to Table 3-1 in Paragraph 3.6.3.3). This UUO clears the "SYS:" program bit JB.LSY (used by 
Batch), clears the execute-only bit, and outputs a SET WATCH VERSION number (refer to 
DECsystem-10 Operating Syste m Commands ). 

3.4.2 SETUUO AC, or CALLI AC, 75^ 

This UUO is used to set various system or job parameters » To set system parameters, the user must be 
logged in under [1, 2] or the job must be running with the JACCT bit set. Refer to the Specifications 
section of the DECsystem-10 Software Notebooks for a complete description of the privileged functions. 

The contents of AC contain a function code in the left half and an argument in the right half. The 

call is: 

MOVE AC, [XWD function, argument] 

SETUUO AC, ;or CALLI AC, 75 

error return 

normal return 



This UUO depends on FTSET which is normally off in the DECsystem-1040. If FTSET is on, 
individual functions depend on the other feature test switches as noted in the text. 
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The functions and arguments ore as follows: 



Function 



Name 






.STCMX 


CORMAX. 


1 


.STCMN 


CORMIN. 


2 


.STDAY 


DAYTIME. 


3 


.STSCH 


SCHED. P 


4 


.STCDR 


CDR (input 



7 
10 

n 

12 

13 
14 



STSPL 



.STWTC 



.STDAT 
.STOPR 
.STKSY 
.STCLM 
.SHLM 
.STCPU 



Argument 

Privileged function. 

Privileged function. 

Privileged function (FTSEDAT). 

Privileged function. 

CDR (input name counter for this job). Not a privileged 
function. If AC is non-zero, the content is the same as 
the next input name. If AC is 0, the current counter is 
returned in AC (FTSPL). 

SPOOL for this job. Not a privileged function unless 
the user is unspooling devices. Bits are bits 31-35 of 
.GTSPL (FTSPL). 
Bit 35 JS.PLP line printer spooling 

Bit 34 JS.PPL plotter spooling 

Bit 33 JS.PPT paper tape punch spooling 

Bit 32 JS.PCP card punch spooling 

Bit 31 JS.PCR card reader spooling 

WATCH for this job. Not a privileged function. Bits 
are bih 1-6 of .GTWCH (FTWATCH). 



tl JW.WDY watch time of day 

t 2 JW.WRN watch run time 

t3 JW.WWT watch wait time 

1 4 JW.WDR watch disk reads 

1 5 JW.WDW watch disk writes 

t6 JW.WVR watch version numbers. 



DATE. Privileged function (FTSEDAT). 

OPR. Privileged function. 

KSYS. Privileged function (FT5UUO). 

CORE limit. Privileged function (FTTLIM). 

TIME limit for this job. Privileged function (FTTLIM). 

CPU specification for this job.. The following bits 
select the CPU on which the job is allowed to run. 



15 
16 



STCRN 
,STLMX 



Bit 35 
Bit 34 
Bit 33 
Bit 32 
Bit 31 
Bit 30 



SP.CRO 
SP.CRl 
SP.CR2 
SP.CR3 
SP.CR4 
SP.CR5 



CPUO 
CPUl 
CPU2 
CPU3 
CPU4 
CPUS 



CPU runnabilit/o Privileged function. 
LOGAAAX. Privileged function. 
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Function 


Name 


17 


.STBMX 


20 


.STBMN 


21 


.STDFL 



Argument 
BAT MAX. Privileged function. 

BATMIN. Privileged function. 

DSKFUL for this job. Not a privileged function. An 
argument of (.DFPSE) causes a pause and an argument 
of 1 (.DFERR) causes an error when the disk is full or the 
user's quota is exceeded. The current setting can 
be determined by issuing an argumesnt other than or 1 . 
The value returned is either or 1 depending on whether 
PAUSE or ERROR is set. The initial setting is ERROR. 



The error return is given if 1) the UUO is not implemented, 2) the user does not have the correct 
privileges for the function specified^, or 3) the argument specified is invalid. 

On a norma! return, AC remains unchanged. 

3.4.3 LOCATE AC, or CALLI AC, 62^ 

This UUO is used to change the logical station associated with the user's job. The call is: 

MOVE! AC, station number 

LOCATE AC, ;or CALLI AC, 62 

error return 

normal return 

The station number requested is contained in AC as follows: 

-1 changes the job's location to the physical station of the job's 
controlling terminal. 

changes the job's location to the central station, 

n changes the job's location to remote station n. 

The normal return is taken if the UUO is implemented, the station is defined, and the station is in 
contact. Subsequent generic device specifications are at the new station. The error return is taken 
if the UUO is not implemented or the specified station is illegal or not in contact. 

3.5 INTER-PROGRAM COMMUNICATION 

3.5.1 TMPCOR AC, or CALLI AC, 44^ 

This UUO allows a job to leave several short files in core from the running of one user program or 
system program to the next. These files are referenced by a three -character filename and are unique 



This UUO depends on FTREM which is normally off in the DECsystem-1040. 
2 
This UUO depends on FTTMP which is normally off in the DECsystem-1040. 
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to each job. All RIes are deleted when the |ob is killed. This system of tenporary storage improves 
response time and reduces the number of disk operations. If this UUO fails, the file specification 
DSK:nn„NAM.TMP, where nnn is the job number and NAM is the three-character filename, should 
be used for temporary disk storage. 

Each temporary file appears to the user as one dump mode buffer. The actual size of the file, the 
number of temporary files a user can have, and the total core a user can use for temporary storage 
are parameters determined at MONGEN time. All temporao^ Hies reside In a fixed area, but the 
space Is dynamically allocated among different jobs and several different files for any given fob. 
The call is: 

MOVE AC, [XWD CODE, BLOCK] 

TMPCORAC, ;orCALLIAC,44 

error return 
normal return 



""°^''^ ;^D NA^E, .NAME is filename 

lOWD BUFLEN, BUFFER ;„„r buffer area 

; (zero for no buffer) 
The AC must be set by the user program prior to execution of the UUO and is changed by the UUO on 
return to a value that depends on the particular function performed. Functions of the TMPCOR UUO 
are presented In the following paragraphs. 

3.5. 1 . 1 CODE = (.TCRFS), Obtain Free Space - This Is the only form of the UUO that does not 
use a two-word parameter block and, therefore, the contents of AC are ordinarily set to 0. A normal 
return is given (unless the UUO Is not implemented), and the number of the free words available to 
the user Is returned in AC . 

3.5.1 .2 CODE = 1 (.TCRRF), Read File - If the specified file is not found, the number of free 
words available for temporary files is returned In AC and the er«,r return is taken. If the specified 
file Is found, the length of the file in words (that Is, the length in BUFLEN when writing the file 
rounded up to the next highest multiple of four) Is returned in AC, and as much of the file as possible 
is copied into the user's buffer. The user may check for truncation of the file by comparing the 
contents of AC with B UFLEN . 

3.5.1 .3 CODE = 2 (.TCRDF), Read and Delete File - This function Is similar to CODE = 1, except 
that if the specified file is found. It Is deleted and Its space is reclaimed. 
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3.5.1 .4 CODE = 3 (.TCRWF), Write File - If a file exists with the specified name, it is deleted 
and'its space reclaimed. The requested size of the file is the value in BUFLEN rounded up to the 
next highest multiple of four. If there is enough space 

a. The file is written. 

b. The number of remaining blocks is returned in AC. 

c. The normal return is taken. 

If there is not enough space to completely write the file 

a. The file is not written. 

b. The number of free words available to the user is returned in AC. 

c . The error return is taken . 

3.5.1 .5 CODE = 4 (.TCRRD), Read Directory - The number of different files In the temporary file 
aLa of the job is retimed in AG. An entry Is made for each file in the user's buffer area until either 
there Is no more space or all files have been listed. The error return is never tdcen. The user may 
check for truncation of the entries by comparing the contents of AC with BUFLEN . The format of a 
directory entry is as follows: 

XWD NAME, SIZE 
where NAME is the filename and SIZE is the file length in words. 

3 5 1.6 CODE = 5 (.TCRDD), Read and Clear Directory - This function is similar to CODE = 4, 
except that any files in the temporary storage area of the job are deleted and their space is reclaimed. 
This UUO is used by the LOGOUT program. 

3.6 ENVIRONMENTAL INFORMATION 

3.6.1 Timing Information 

The 5.05 and later monito,, use hvo time and two date standards. The time accounting is performed 
by two clocks. The APR clock, driven by the power source frequency (60 Hz in North America, 
50 Hz in most other countries), is accurate over long periods of time. For this reason, it is used to 
keep the time of day, e.g., for the TIMER UUO. It can also be used for runtime accounting measure- 
ment (i.e., keeping track of the processor time each job uses). However, there will be some loss of 
accuracy since the time intervals in which a job runs are often less than the period of the APR clock. 
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The DK10 clock, a 100000 Hz clock, is accurate over short periods of time. It is used to perform 
runtime accounting, and thereby achieves greater accuracy than the APR clock. 

I The traditional DECsystem-10 date (returned with the DATE UUO) is a 15-bit integer. This integer is 
incremented by 1 each day, by 31 each month (regardless of the actual number of days in the month), 
and by 12*31 each year (also regardless of the actual number of days in the year). This date format 
is easy to resolve into year-month -day; however, the difference between two dates in this format is 

I not necessarily the actual number of days between them. 

A universal date-time standard (GETTAB table 11, item 53) is also used in which the left half of the 
word is the date and the right half is the time. The date is uniformly incremented each day (at 
midnight, Greenwich Mean Time) with 1 being November 18, 1858. This date is consistent with the 
Smithsonian Astronomical Date Standard and other computer systems. The time is a fraction of a day. 
Thus, the 36-bit quantity is in units of days with a binary point between the left and right halves. 
The resolution is approximately 1/3 of a second; that is, the least significant bit (bit 35) represents 
approximately 1/3 of a second. Since the time is Greenwich Mean Time (GMT), all installations 
have a date-time reference which is independent of location and local time conventions. 

For convenience, the monitor maintains a set of GETTAB values which gives the local date and time 
in terms of year, month, day, hours, minutes, and seconds (GETTAB table 11, items 56-63). 

I 3.6. 1 . 1 DATE AC, or CALLI AC, 14 - A 15-bit binary integer computed by the formula 
date=((year-1964)xl2+(month-l))x31+day-l 
represents the date. 
This integer representation is returned right justified in AC. 

3.6.1 .2 TIMER AC, or CALLI AC, 22 - This UUO returns the time of day, in clock ticks (jiffies), 
right justified in AC. A jiffy is 1/60 of a second (16.6 milliseconds) for 60-cycle power and 1/50 
of a second (20 milliseconds) for 50-cycIe power. The MSTIME UUO should normally be used so 
that the time is not a function of the cycle. 

3.6.1 .3 MSTIME AC, or CALLI AC, 23 - This UUO returns the time of day, in milliseconds, right 
justified in AC. 
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3.6.2 Job Stafus InformaHon 

3.6.2.1 RUNTIM AC, or CALLI AC, 27 - The accumulated running time (in milliseconds) of the 
job number specified in AC is returned right justified in AC. If the job number in AC is zero, the 
running time of the currently running job is returned. If the job number in AC does not exist, zero 
is returned. 

3.6.2.2 PJOB AC, or CALLI AC, 30 - This UUO returns the job number right justified in AC. 

3.6.2.3 GETPPN AC, or CALLI AC, 24 - This UUO returns in AC the project -programmer pair of 
the job. The project number is a binary number in the left half of AC, and the programmer number 
is a binary number in the right half of AC . If the program has the JACCT bit set, a skip return is 
given if the old project-ptogrammer number is also logged in on another job, 

3.6.2.4 OTHUSR AC, or CALLI AC, T7 - This UUO is used to determine if another job is logged 
in with the same project -programmer number as the job executing the UUO. The non-SKIP return 
is given if 

1) the UUO is not implemented, in which case the AC remains unchanged, or 

2) the UUO is implemented and no other jobs are logged in with the same 
project -prog rammer number, in which case the AC contains the project- 
programmer number of the job executing the UUO, 

The SKIP return is given if the UUO is implemented and other jobs are logged in with the same 
project-programmer number. The AC contains the pro ject-programmern umber of the job executing 
the UUO, This UUO is used by KJOB. 

3.6.3 Monitor Examination 

3.6.3. 1 PEEK AC, or CALLI AC, 33 - This UUO allows a user program to examine any location in 
the monitor. It is used by SYSTAT, FILDDT, and DATDMP and could be used for on-line monitor 
debugging. The PEEK UUO requires bit 16 (JP.SPA - examine all of core) and/or bit 17 (JP.SPM - 
examine the monitor) to be set in the privilege word . GTPRV. 

The call is: 

MOVEI AC, exec address ;TAKEN MODULO SIZE OF MONITOR 

PEEK AC, ;OR CALLI AC, 33 

This call returns with the contents of the monitor location in AC. 

3.6.3.2 SPY AC, or CALLI AC, 42 - This UUO is used for efficient examination of the monitor 
dicing timesharing. Any number of K of physical core (not limited to the size of the monitor) is 
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placed into the user's logical high segment. This omount cannot be saved with the monitor SAVE 

command (only the low segment is saved), cannot be increased or decreased by the CORE UUO 

(error return taken), or cannot have the user-mode write-protect bit cleared (error return taken). 

The call is: 

MOVEI AC, highest physical core location desired 
SPY AC, ;or CALLI AC, 42 

error return 
normal return 

Any program that is written to use the SPY UUO should try the PEEK UUO if it receives an error 

return. The SPY UUO requires bit 16 (JP.SPA - examine all of core) an4/or bit 17 (JP.SPM - 

examine the monitor) to be set in the privilege word .GTPRV. 

3.6.3.3 POKE. AC, or CALLI AC, 114 - This UUO is used by a privileged user to alter one loca- 
tion in the monitor at a time. The POKE. UUO requires bit 4 (JP.POK) to be set in the privilege 
word .GTPRV. 

The call is: 

MOVE AC, [3,, ADR] 

POKE. AC, ;or CALLI AC, 114 

error return 

normal return 

ADR: monitor location 

old value 
new value 

The error return is given if: 

The user is not privileged; AC contains 0. 

The value specified in ADR+1 as the old value is not the same as the actual value 
contained in the monitor location; AC contains 1 . 

The address specified is not a valid monitor address; AC contains 2, 

3.6.3.4 GETTAB AC, or CALLI AC, 41 - This UUO provides a mechanism which will not vary 

from monitor to monitor for user programs to examine the contents of certain monitor locations. 

The call is: 

MOVE AC, [XWD index, table number] 

GETTAB AC, ;or CALLI AC, 41 

error return 

normal return 



This UUO depends on FTPOKE which is normally off in the DECsystem-1040. 
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The left half of AC contains a job number or some other index to a table. Some jdj numbers may 
refer to high segments of programs by using arguments greater than the highest job number for the 
current monitor. A LH of -1 indicates the current job number. A LH of ^2 references the job's high 
segment. An error return is given if there is no high segment or if the hardware and software are 
n on -reentrant. The right half of AC contains a table number from the list of monitor data tables and 
parameters in Table 3-1. The entries in these tcfcles are globals in the monitor subroutine COMMON. 
The actual values of the core addresses of these locations are subject to change and can be found in 
the LOADER storage map for the monitor. The complete description of these globals is found in the 
listing of COMMON. 

The customer is allowed to add his own GETTAB tables to the monitor. A negative right half should 
be used to specify such customer-added tables. 

An error return leaves the AC unchanged and is given if the job number or index number in the left 
half of AC is too high, the tchle number in the right half of AC is too high, or the user does not have 
the privilege of accessing the specified table. 

A normal return supplies the contents of the requested table in AC, or a zero if the table is not defined 
in the current monitor. 

The SYSTAT program mcdces frequent use of this UUO. 

NOTE 

Many GETTAB tables have information in the undescribed 
bits. This information is likely to change and should be 
ignored. Although the field may currently be zero, there 
is no reason to believe that it will always be zero. 
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Table 3-1 
GETTAB Tables 



Table Nurriiers 
(RH of AC) 



00 
01 

02 

03 

04 

05 
06 

07 

10 
11 

12 

13 

14 



15 
16 



Table Names 



.GTSTS 
.GTADR 

.GTPPN 

.GTPRG 

.GTTIM 

.GTKCT 
.GTPRV 

.GTSWP 

.GTTTY 
.GTCNF 

.GTNSW 

oGTSDT 

.GTSGN 



.GTODP 
.GTLDV 



Explanation 



Job status word; index by job or segment number. 

Job relocation and protection; index by job or 
segment number 

Project and programmer numbers; index by job or 
segment number 

User program name; index by job or segment 
number. 

Total ain time used in units of jiffies; index by 
job number. The value of a jiffy can be obtained 
from bit 6 of the STATES word (item 17 in the 
.GTCNF table). 

Kilo-Core ticks of job; index by job number. 

Privilege bits of job; index by job number, refer 
to Paragraph 3.6.3.4.1 . 

Swapping parameters of job; index by job or seg- 
ment number. 
Terminal -to-job translation; index by job number. 

Configuration table; index by item number, refer 
to Paragraph 3.6.3.4.2. 

Nonswapping data; index by item number, refer to 
Paragraph 3.6.3.4.3. 

Swapping data; index by item number, refer to 
Paragraph 3.6.3.4.4. 

High segment tcfole; index by job number. 
Bit = 0, then bits 18-35 are index of high segment 
(if bits 18-35 = 0, then there is no high segment). 
Bit = 1, then bits 18-35 are number of K to spy on 
Bit 1 (SN%SHR) = 1 if job has a high segment that 

is sharable. 

Bit 5 (SN%LOK) = 1 if job has a high segment that 

is locked. 

Once-only disk parameters; index by item number, 
refer to Paragraph 3.6.3.4.5. 

5_series monitor disk parameters; index by item 
number, refer to Paragraph 3.6.3.4.6. 
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Table 3-1 (Cont) 
GETTAB Tables 



Table Numbers 
(RHof AC) 



17 



20 



21 
22 
23 

24 

25 

26 
27 



30 
31 

32 

33 
34 
35 

36 

37 



Table Names 



.GTRCT 



.GTWCT 



.GTDBS 
.GTTDB 
.GTSLF 

.GTDEV 

.GTWSN 

.GTLOC 
GTCOR 



.GTCOM 
.GTNMl 

.GTNM2 

.GTCNO 

.GTTMP 

.GTWCH 

.GTS PL 

. GTRTD 



Explanofion 



Disk blocks read by job; used by DSK command: 

a. Bits 0-11 = incremental blocks 

b. Bits 12-35 = total blocks since start of job. 
Index by job number. Job indicates the number 
of blocks swapped in. 

Disk blocks written by job: 

a. Bits 0-11 = incremental blocks, 

b. Bits 12-35 = total blocks since start of job. 
Index by job number. Job indicates the number 
of blocks swapped out. 

Reserved for future. 

Reserved for future. 

Table of GEHAB addresses (GETTAB immediate); 
index by GETTAB table number, refer to 
Paragraph 3.6.3.4.7. 

Device or file structure name of sharable high seg- 
ment. Index by high segment number. 

Two-character SIXBIT names for job queues; index 
by item numbers, refer to Paragraph 3.6.3.4.8. 

Job's logical station; index by job number. 

Physical core allocation. One bit per c»ie K of 
core if system does not include LOCK UUO. Two 
bits per entry if system includes LOCK UUO. A 
non-zero entry indicates core in use. 

Table of SIXBIT names of monitor commands. 

First half of name of user in SIXBIT; index by job 
number. 

Last half of name of user in SIXBIT; index by job 
number. 

Job's charge number; index by job number. 

Job's TMPC OR pointers; index by job number. 

Job's WATCH bits; index by job number, refer to 
Paragraph 3.6.3.4.9. 

Job's spooling control bits; index by job number, 
refer to Paragraph 3.6.3.4.10. 

Job's real-time status word; index by job number. 
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Table 3-1 (Cont) 
GETTAB Tables 



Table Numbers 
(RHof AC) 



40 



45 
46 
47 
50 



51 



52 
53 



Table Names 



GTUM 



41 


.GTQQQ 


42 


.GTQJB 


43 


.GTCM2 


44 


. GTCRS 



.GTISC 
.GTOSC 
• GTSSC 
.GTRSP 



.GTSYS 



»GTWHY 
.GTTRQ 



Explanation 



Job's time limit in jiffies and Batch status; index by 
job number. 

a. Bits 1-9 (JB.LCR)= job's core limit. 

b. BltlO=l (JB.LBT) ifaBatchJob. 

c. Bit 11 = 1 (JB.LSY) if program comes from SYS. 
Set on R command or equivalent. Cleared on R 
command (or equivalent) or SETNAM UUO. 

d. Bits 12-35 (JB.LTM)= job's time limit. 

Timesharing scheduler's queue headers. 

Timesharing scheduler's queue that jda is in; index 
by job number. 

Table of SET command names. 

Status of hardware taken on a crash. 

0: CR.SAP=CONIAPR, 

1: CR.SPI= CONIPI, 

2: CR.SSW = DATAIAPR 

The remainder of the table contains the status of 

the various devices. 

Swapper's input scan list of queues. 

Swapper's output scan list of queues. 

Scheduler's scan list of queues. 

Response counter, tdile. Time in jiffies when user 
started to wait for his job to run. This time is 
cleared when the job is first given to the processor 
by the scheduler. 

System variables which are independent of CPU. 
Word (%SYERR) = system wide hardware error count. 
Word 1 (%SYCCO) = number of times COMCNT 
was off. 

Word 2 (%SYDEL) = number of error-logging dis- 
abled errors. 

Word 3 (%SYSPC) = LH fs a 3- letter code of the 
lastSTOPCD. 

RH is the address +1 of the last STOPCD executed. 
Word 4 (%SYNDS) = number of debug STOPCDs. 
Word 5 (%SYNJS) = number of job STOPCDs. 
Word 6 (%SYNCP) = total number of commands 
processed by the system since it was started. 

Operator why comments in ASCIZ. 

Total time \ch was in run queues whether it was 
running or not. 
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Table 3-1 (Cont) 
GETTAB Tables 



Table Numbers 
(RHof AC) 



54 



Table Names 



.GTSPS 



55 


.GTCOC 


56 


.GTCOV 


57 


.GTCIC 


60 


.GTCIV 


61 


.GTC2C 


62 


.GTC2V 


63 


.GTC3C 


64 


.GTC3V 


65 


,GTC4C 


66 


.GTC4V 


67 


.GTC5C 


70 


.GTC5V 


71 


.GTFIET 


72 


.GTEDN 



Explanation 



Job status word of second processor. 
Bit 29 (SP.SCO) = SET CPU command can be used. 
Bit 35 (SP.CRO) = SET CPU UUO can be used. 
Bits for other processors can be obtained by shifting 
left 1 bit per processor. 

CPUO CDB constants; index by item number, refer 
to Paragraph 3.6.3.4.11. 

CPUO CDB variables; index by item number, refer 
to Paragraph 3.6.3,4.12. 

CPUl CDB constants; index by item number; see 
.GTCOC. 

CPUl CDB variables; index by item number; see 
.GTCOV. 

CPU2 CDB constants; index by item number; see 
.GTCOC. 

CPU2 CDB variables; index by item number; see 
.GTCOV. 

CPU3 CDB constants; index by item number; see 
„ GTCOC. 

CPU3 CDB variables; index by item number; see 
.GTCOV. 

CPU4 CDB constants; index by item number; see 
.GTCOC. 

CPU4 CDB variables; index by item number; see 
.GTCOV. 

CPU5 CDB constants; index by item number, see 
.GTCOC. 

CPUS CDB variables; index by item number; see 
.GTCOV. 

Current setting of all features defined in F.AAAC, 
index by item number, refer to Paragraph 3.6.3.4. 14. 

Table of ersatz device names (e.g., NEW, LIB) 
with their corresponding project-programmer num- 
bers. The search lists of these devices can be 
obtained from the PATH. UUO. 
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3.6.3.4. 1 Entries in Table 6- .GTPRV (Privilege Table) 

Each job has a one-word entry to indicate job privileges. The privilege bits are as follows: 

Meaning 

Highest disk priority for this job. 

Job is allowed to execute the METER. DUO. 

Job is allowed to execute the POKE.UUO. 

Job is allowed to change its CPU specification 
via a command or UUO. 

Highest high-priority queue available to this job. 

Job is allowed to unspool devices. 

Job is allowed to execute the RTTRP UUO. 

Job is allowed to execute the LOCK UUO. 

Job is allowed to execute the TRPSET UUO. 

Job is allowed to PEEK and SPY on all of core. 

Job is allowed to PEEK and SPY on the monitor. 



Bit 


Mnemonic 


1-2 


JP.DPR 


3 


JP.MET 


4 


JP.POK 


5 


JP.CCC 


6-9 


JP.HPQ 


10 


JP.NSP 


13 


JP.RTT 


14 


JP.LCK 


15 


JP.TRP 


16 


JP.SPA 


17 


JP.SPM 



3.6.3.4.2 Entries in Table 11 - .GTCNF (Configuration Table) 

Item Location Use 

Name of system in ASCIZ. 

bate of system in ASCIZ. 






%CNFGO 


4 


%CNFG4 


5 


%CNDTO 


6 


%GNDT1 


7 


%CNTAP 


10 


%CNTIM 


11 


roCNDAT 


12 


%CNSIZ 


13 


%CNOPR 


14 


%CNDEV 


15 


%CNSJN 


16 


%CNTWR 



Name of system device (SIXBIT). 

Time of day in jiffies. 

Today's date (15-bit format). 

Highest location in monitor +1 „ 

Name of OPRTTY (SIXBIT). 

LH is start of DDB (device -data-block) chain, 

LH^-*^ of high segments, RI+=+* of jobs 
(counting NULL job). 

Non-zero if system has two-register hardware and 
software . 
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Item 
17 



Locafion 



%CNSTS 



20 
21 



%CNSER 
%CNNSM 



Use 



Location describing feature switches of this system 
in LH, and current state in RH, 

Assembled according to MONGEN dialog and 

S.AAAC: 

B 

B 

B 

B 

B 

B 



t 0=1 if disk system (SF/oDSK) 
t 1=1 if swap system (SF/oSWP) 
t 2=1 if LOGIN system (ST%LOG) 
t3=l if full duplex software (ST%Fn) 
t 4=1 if privilege feature (ST%PRV) 
t 5=1 if assembled for choice of reentrant or non- 
reentrant software at monitor load time (ST%TWR) 
Bit 6=1 if clock is 50 cycle instead of 60 cycle 

(ST%CYC) 
Bit 7-9 type of disk system (ST%TDS): 
if 0, 4-series disk system, 
if 1, 5-series disk system, 
if 2, spooled disk. 
Bit 10=1 if independent programmer numbers be- 
tween project (INDPPN is non-zero) (ST%IND) 
Bit 11=1 if image mode on terminal (8-bit SCNSER) 

(ST%IMG) 
Bit 12=1 if dual processor system (ST%DUL) 
Bit 13=1 if multiple RIBs supported (SF/oMRB) 
Bit 14«1 if high precision time accounting (ST%HPT) 
Bit 15 = 1 if overhead excluded from time account- 
ing (ST%EMO) 
Bit 16=1 if real-time clock (ST%RTC) 



Bit 17=1 if built to handle FOROTS (ST%MBF) 

Set by the privileged operator command, SET 

SCHED: 

Bit 27=1 means no operator (ST%NOP) 

Bit 28=1 means unspooling devices (ST%NSP) 

Bit 29=1 means assigning devices (ST%ASS) 

Bit 33=1 means only Batch Jobs may LOGIN (except 

from CTY or OPR) (ST%BON) 
Bit 34=1 means no remote LOGlNs (ST%NRL) 
Bit 35=1 means no more LOGlNs except from CTY 

or OPR (ST%NLG) 

Serial number of PDP-10 processor. Set by 
MONGEN dialog. 

Number of nanoseconds per memory cycle for memory 
system. If the GETTAB fails, the nurnber of nano- 
seconds per memory cycle is t DIOOO. Used by 
SYSTAT to compute shuffling time. 
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Item 
22 



Location 



%CNPTY 



23 
24 

25 
26 

27 
30 

31 
32 

33 
34 



35 

36 
37 
40 

41 



%CNJRE 
%CNLOC 

%CNSTB 
%CNOPL 

%CNTTF 
%CNTTC 

%CNnN 
%CNLNS 

%CNLNP 
%CNVER 



%CNDSC 

%CNDLS 
%CNCCI 
%CNSGT 

%CNPOK 



Use 



PTY pdra meters for Batch. 

LH = the number of the first invisible terminal 
(which is one greater than the number of the CTY) 
RH = the number of PTY' s in the system configura- 
tiono 

AOBJN word to use bit map In monitor for alloca- 
ting 4"Word core blocks. 

LH=0, RhNaddress in monitor for free 4-word core 
block areaso (This is never changed wKile 
monitor runs). 

Link to STB chain for remote Batch. 

Address of the line data block (LDB) of the 
operator's terminal. 

Pointer to TTY free chunks. 

LH=number of TTY chunks, 
RH=address of first TTY chunk. 

Number of free TTY chunks. 

Pointer to current TTY as seen by the command 
decoder. 

Pointer to examine TTY line table, including 
remote terminals. 
LH= -total number of TTY lines. 
RH=beginning of line table. 

Version of monitor. (Stored in location 137 of 
monitor as a save file when monitor is not running.) 
Bits 0-17 reserved for customer. 
Bits 18-23 monitor level (e.g., 5) 
Bits 24-29 monitor release (e.g., 3). 
Bits 30-35 used for internal development, 
if the GETTAB fails, the monitor is a version 
previous to 5.03 

Pointer to datd set control table. 

LH= "length of table. 

RH= beginning of control table. 

Last received interrupt from the DCIO. 

Last received interrupt from the 6801. 

Last dormant segment which was deleted to free a 
segment number. 

Address of last location changed in monitor by the 
POKE.UUO. 
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Item 


Location 


42 


%CNPUC 


43 


%CNWHY 



44 



45 
46 



47 



%CNTIC 



%CNPDB 
%CNRTC 



%CNCHN 



50 


%CNLMX 


51 


%CNBMX 


52 


%CNBMN 


53 


%CNDTM 


54 


%CNLNM 


55 


%CNBNM 


56 


%CNYER 


57 


%CNMON 


60 


%CNDAY 


61 


%CNHOR 


62 


%CNMIN 


63 


%CNSEC 



Use 



LH = the number of the job which successfully 

executed the POKE.UUO last. 
RH= the number of successful POKE.UUOs executed. 

The reason for the last reload (SIXBIT unabbreviated 
operator answer). Refer to ONCE in the DEC- 
system-10 Software Notebooks. 

The number of clock ticks per second. This is the 
time-of-day clock. The number is obtained by 
conductir^ a simple experiment at monitor load 
time. A different clock can be used for increm- 
ental run time accounting (refer to %CNRTC 
below). 

The pointer to the process data block (PDB) pointer 
tables. 

The run time clock rate (jiffies per second). That 
is, the rate of the clock used to measure the run 
time of the job and the system statistics (null, lost, 
and overhead time). This is the precision of the 
measurement, not the units of measurement. 

The pointer to the list of channel (DFIO) data 

blocks. 

LH = the address of the 1st channel data block. 

RH = unused. 

LOGMAX. The maximum number of jobs allowed 
to LOGIN. 

BATMAX. The maximum number of Batch jobs 
allowed to LOGIN. 

BATMIN . The guaranteed number of Batch jobs 
(i.e., the number of jobs reserved for Batch). 

The universal date -time standard (refer to 
Paragraph 3.6. 1). 

LOGNUM. The number of jobs currently logged-in. 

BATNUM. The number of Batch jobs currently 
logged-in. 

LOCYER. The year. 

LOCMON. The month (Jan =1, Feb = 2, etc.), 

LOCDAY. The local day of the month (1, 2, 
3,...). 

LOCHOR. The local hour in 24-hr format. 

LOCMIN. Minutes(0, 1, . . . , 59). 

LOCSEC. Seconds (0, 1, . . ., 59). 



3-42 



March 1973 



-^27- 



HONITOR CALLS 



Item 


Location 


64 


%CNGMT 


65 


%CNDBG 



66 



%CNFkU 



Use 



Offset for the universal date-time standard in order 
to convert it to local time from Greenwich Mean 
Ti me (not yet i mp I emen ted ) . 

Debugging status word. 

Bit 0=1 System debugging (ST%DBG). 

Bit 1=1 Reload on debug stop code (ST%RDC). 

Bit 2=1 Reload on job stop code (ST%RJE). 

Amount of free core currently in use by the 
monitor. 



3.6.3.4.3 Entries in Table 12 - .GTNSW (Nonswapping Data) 

no new entries will be added to the .GTNSW table because many 
dependent upon the processor used and therefore are different for 
system. GETTAB tables 51-70 exist for new parameters as well as 



With the 5»05 and later monitors, 
of the parameters in this table are 
each processor in a multiprocessor 
the .GTNSW parameters. 



Item 


Location 







7 




10 


% NSC MX 


n 


%NSCLS 


12 


%NSCTL 


13 


%NSSHW 


14 


%NSHLF 


15 


%N5UPT 


16 


%NSSHF 


17 


%NSSTU 


20 


%NSHJB 


21 


%NSCLW 


22 


%NSLST 



Use 
Obsolete, 
unspecified data. 

CORMAX. Size in words of largest legal user 
job +1 (Low seg+high seg). 

Byte pointer to last free block. 

Total free+dormant+idle K physical core left 
(virtual core). 

Job number shuffler has stopped. 

Absolute address of job above lowest hole, if 
no job. 

Time system has been up in jiffies. 

Total number of words shuffled by system. 

Number of \d> using SYS if not a disk. 

Highest job number currently assigned. 

Total nurrfoer of words cleared by system. 

Total number of clock ticks when null jc^ ran and 
other jobs wanted to but could not because: 

a. Swapped out or on way in or out. 

b. Monitor waiting for I/O to stop so it can shuffle 
or swap, 

c. Job being swapped out because of expanding 
core. 
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23 
24 

25 

26 
27 

30 

31 

32 

33 

34 
35 
36 

37 
40 
41 
42 
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43 



44 



Location 

%NSMMS 
7oNSTPE 

%NSSPE 

%NSMPC 
%NSMPA 

%NSMPW 

%NSMPP 

%NSEPO 

%NSEPR 

%NSNXM 

%NSKTM 

%NSCMN 

7oNSABC 
%NSABA 
%NSLJR 
7oNSACR 



Use 



%NSNCR 



%NSSCR 



Size of physical memory in words. 

Total number of user parity errors (memory) since 
system was loaded. 

Total number of spurious (refer to Paragraph 7,7) 
parity errors (memory). 

Total nunrfoer of multiple parity errors (memory). 

The absolute location of the last user mode mem- 
ory parity error. 

The contents of the last user mode memory parity 
error. 

The user PC of the last user mode memory parity 
error. 

Total number of PDL OVR's at UUG level in exec 
mode which were not recovered. 

Number of PDL OVR's at UUO level which were 
recovered by assigning extended list. 

Highest legal value of CORMAX. 

Count-down timer for SET KSYS UUO. 

ArTK)unt of core guaranteed to be available after 
locking jobs in core (CORMIN). 

Count of number of address breaks handled. 

Contents of data switches on last address break. 

Last job that ran if different from the current job. 

Accumulated CPU response. Total number of 
jiffies that all users waited for their jobs to 
initially run after either a command v/as issued 
which ran a job (program) or terminal input was 
given that removed the job from a TTY input wait 
state. 

Number of CPU responses for all us6rs waiting for 
jobs to run (refer to %NSACR above). Dividing 
the value of %NSACR by the value of %NSNCR 
gives the average response time since system startup. 

Accumulated squares of the CPU response times 
obtained from %NSACR. 
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Item 



Location 






%SWBGH 


1 


%SWFIN 


2 


%SWRC 


3 


%SWFIT 


4 


%SWVRT 



%SWERC 



%SWPIN 



Use 



Number of K in biggest hole in core. 

-Job number of job being swapped out, 
+Job number of job being swapped in. 

Job being forced to swap out. 

Job waiting to be fit into core. 

Amount of virtual core left in system in K 
(initially set to number of K of swapping space). 

LH=number of swap read or write errors, 
RH=error bits (bits 18-21 same as status bits) + 
number of K discarded. 

-1 if job swqaped in (monitors which swap process 
data blocks (PDBs) only). 



3.6.3.4.5 Entries in Table 15 - .GTODP (Once-Only Disk Parameters) 
Item Location ^ff 

%ODSWP Unused, contains zero in 5-series monitors. 

1 %ODK4S 



%ODPRT 
%ODPRA 



K of disk words set aside for swapping on all units 
in active swapping list. 

In-core protect time multiplies size of job in K-1 . 

In-core protect time added to above result after 
multiply. 



3.6.3.4.6 Entries in Table 16 - .GTLVD (5-series Monitor Disk Parameters) 



Item 


Location 





%LDMFD 


1 


%LDSYS 


2 


%LDFFA 


3 


%LDHLP 


4 


%LDQUE 


5 


%LDSPB 



Use 

Project-programmer number for UFDs only [1, 1] . 

Pro}ect-programmer number for device SYS [1,4]. 
In 4-series monitors [1,1]. 

Project-programmer number for FAILSAFE [1,2]. 

Project-programmer number for SYSTAT and HELP 
[2,5]. 

Project -programmer number for spooling programs 
[3,3]. 

a. LhNaddress of first PPB block. 

b. RB=address of next PPB block to be scanned. 
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Item 
6 



Location 
%LDS7R 



10 

n 

12 
13 
14 
15 

16 

17 

20 
21 

22 

23 

24 



%LDUNI 

%LDSWP 

%LDCRN 

%LDSTP 

%LDUFP 

%LDMBN 

%LDQUS 

%LDCRP 

%LDSFD 

%LDSPP 
%LDSYP 

%LDSSP 

%LDMNU 

%LDMXT 



25 



%LDNEW 



Use 

a. LH=address of first file structure cfcita block. 

bo RH=relative address of next file structure data 
block, i.e., the address within the data block 
which points to the actual address of the next 
data block . 

a. LH=address of data block of first unit in system. 

b. Rl+=relative address of data block of next unit 
in system. 

a. Lh+=address of first unit for swapping in system. 

b. Rl-Nrelative addreiss of next unit for swapping 
in system. 

Number of 4-word access blocks for disk systems 
allocated at ONCE - only time. 

Standard file protection code (057), can be changed 
by installation. Iji 4-series monitors (055). 

Standard UFD protection code (775), can be 
changed by installation. In 4-series monitors (055), 

Number of monitor buffers allocated at once-only 
time (2). In 4-series monitors, 1. 

SIXBIT name of file structure containing 3, 3. UFD 
for spooling and OMOUNT queues. In 4-series 
monitors, DSK. 

UFD used for storing system crashes., In 4-series 
monitors, [10, 1] . 

Maximum number of nested SFD's which the monitor 
allows to be created. 

Protection of spooled output files (bits 0-7). 

Standard protection for files in SYS: (155) except 
for files with an extension of .SYS. 

Standard protection for files in SYS: with an 
extension of .SYS (157). 

Maximum negative argument to USETI which reads 
extended RIBs. 

Maximum number of blocks transferred with one 
I/O operation (one lOWD). Normally 100000 but 
can be defined at MONGEN to be smaller so that 
a job doing high priority disk I/O will be locked 
out for a shorter period of time (since it can be 
locked out for as long as the channel is busy). 

Project -programmer number for experimental 
SYS [1,5]. 
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Item 



Locatfon 



26 


%LDOLb 


27 


%LDUMD 


30 


%LDNDB 



Use 

Project-progrdmmer number for library of super- 
seded system programs [1 /3] . 

Pro|ec1--programmer number for user mode diagnos- 
tics [6,6], 

Default number of disk buffers in a buffer ring. 



3.6.3.4„7 Entries in Table 23 - .GTSLF (GETTAB Immediate) 

This table is useful for a program that uses the SPY UUO for efficiency and needs the core address of 
the monitor tables. Absolute location 151 in the monitor contains the address of the beginning of 
this table. 

The format of each entry is as follows: 

LH=Bits 0-8 - maximurri item number in table. 
Bit 9 = data may be process data. 
Bit 10 = data may be segment data. 
Bits 14-17= a monitor AC. 

RH=executive-mode address of table (item 0). 



Examples: 



XWD ITEM + JBTMXL, JOBSTS 
XWD ITEM + TTPMXL, HYTAB 



3.6.3.4.8 Entries in Table 25 - .GTWSN (Two-character SIXBIT names for job queues) 

Word 

Bits 0-1 1 = contain the two SIXBIT character mnemonic of job state code 0. 
Bits 12-23 = contain the two SIXBIT character mnemonic of job state code 1 , 
Bits 24-35 = contain the two SIXBIT character mnemonic of job state code 2. 



Word 1 



Bits 0-1 1 = contain the mnemonics of job state code 3. 
Bits 12-23 = contain the mnemonics of job state code 4. 
Bits 24-35 = contain the mnemonics of job state code 5. 
etc. 



The job state codes for a disk system are as follows: 

RN - one of the run queues. 

WS - I/O wait satisfied. 

TS - TTY \/0 wait satisfied. 

DS - disk I/O wait satisfied. 

AU - disk alter UFD wait. 
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MQ - disk monitor buffer wait. 

DA - disk storage allocation wait. 

CB - disk core block scan wait. 

Dl ~ DECtape control wait. 

D2 - second DECtape control wait. 

DC - data control wait. 

MT - magnetic tape control wait. 

CA - core allocation wait (to be locked). 

iO - I/O wait. 

Tl - TTY I/O wait. 

Dl - disk I/O wait. 

SL - sleep wait. 

NU - null state. 

ST - stop (to state. 

JD - DAEMON wait. 

These state codes are printed by SYSTAT. Note that SYSTAT displays other codes based on analysis, 
such as the Following: 

TO - TTY output. 

fC - job stopped. 

fW - command wait. 

OW - operator wait. 

HB - hibernate. 



3.6.3.4.9 Entries in Table 35 - .GTWCH (WATCH Table) 

Each job has a one-word entry to indicate the WATCH bits. The bits for each word are as follows: 

Bit Mnemonic Meaning 

1 JW.WDY Watch time of day. 

2 JW.WRN Watch run time. 

3 JW.WWT Watch wait time. 

4 JW.WDR Watch disk reads. 

5 JW.WDW Watch disk writes. 

6 JW.WVR Watch versions. 

3.6.3.4.10 Entries in Table 36 - .GTSPL (Spooling Table) 

Each fob has a one-word entry to indicate the spooling control bits. These bits are as follows: 

Bit Mnemonic Meaning 

35 JS.PLP Line printer spooling. 

34 JS.PPL Plotter spooling. 



JS. 


,PLP 


JS. 


PPL 


JS. 


PPT 


JS, 


PCP 


JS. 


PCR 


JS. 


PRI 



33 JS.PPT Paper tape punch spooling. 

32 JS.PCP Card punch spooling, 

31 JS.PCR Card reader spooling. 

24-26 JS.PRI Disk priority. 
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The items in this table correspond to the items in the constants table for each processor. 



CPU! 


Tables? - 


.GTCIC 




CPU2 


Table 61 - 


,GTC2C 




CPU3 


Table 63 - 


.GTC3C 




CPU4 


Table 6S - 


,GTC4C 




CPUS 


Table 67 - 


.GTC5C 




Item 


Location 




Use 





%CCPTR 




LH=pointer to next CDB, or if this is the last 

CDBo 

RH=unusecl. 


1 


%CCSER 




APR serial number. 


2 


%CCOKP 




If less than or eaual to zero, CPU is runnina ol< 



10 



n 



%CCTOS 

%CCLOG 

%CCPHY 

%CCTYP 



%CCMPT 



%CCRTC 



%CCRTD 



If greater than zero, CPU has stopped running 

correctly. 

Contents of word is the number of jiffies CPU has 

been stopped. 

Trap offset for KAIO interrupt locations (0 or 100). 

Logical CPU name in SIXBIT (CPUn). 

Physical CPU name in SIXBIT (CPAn, CPIn, or 
CP6n). 

Type of processor (LH for customers, RH for DEC) 

1 (.CC166) = PDP-6 

2 (.CCKAX) = KAIO 

3 (.CCKIX) = KI10 

Relative GETTAB pointer to memory parity bad 
address subtable. Refer to Paragraph 3,6.3.4.13. 

Bits 0-8 maximum relative entry in sub- 

table 

Bits 18~3S relative address of first word in 

subtable in CPU variable GETTAB 
(.GTCOV), 

If word is 0, the subtable has been conditionally 
assembled out of the monitor. 

Real time clock (DKIO) DDB. If word is 0, there 
is no real time clock on this CPU. 

Real time clock DDB if high precision time account- 
ing. If 0, there is no high precision time account- 
ing on this CPU. 
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Item 
12 



Local-ion 
%CCPAR 



13 



%CCRSP 



Use 

Relative GETTAB pointer to memory parity subtoble. 
Refer to Paragraph 3.6.3.4.13. 

Bits 0-8 maximum relative entry in 

subtable. 

Bits 18-35 relative address of first word in 

subtable in CPU variable 
GETTAB. (.GTCOV). 

If word is 0, the subtable has been conditionally 
assembled out of the monitor. 

Relative GETTAB pointer to response subtable. 
Refer to Paragraph 3.6.3.4.13. 

Bits 0-8 Maximum relative entry in 

subtable. 
Bits 18-35 relative address of first word in 

subtable in CPU variable GETTAB 

(.GTCOV). 



3.6.3.4. 12 Entries in Table 56 - .GTCOV (CPUO CDB Variable Table) 

The items in this table correspond to the items in the varici»les table for each processor. 

Table 60 - .GTCIV 

Table 62 - .GTC2V 

Table 64 - .GTC3V 

Table 66 - ,GTC4V 

Table 70 - .GTC5V 

Use 

Uptime in jiffies for this CPU. 

Lost time in jiffies for this CPU. 

Total memory parity error words detected during all 
CPU sweeps on this CPU while processor was in 
exec OT user mode. If the system halts, this 
location has already been updated. 

Total spurious memory parity errors detected on this 
CPU (i.e., errors which did not reoccur when the 
CPU swept through core). Can occur on a read- 
pause-write which rewrites memory or on a channel- 
detected parity not found on the sweep (refer to 
%CVPCS in parity subtable.) 

Multiple memory parity errors for this CPU. That 
is, the number of time the operator pushed 
CONTINUE after a serious memory parity halt. 
LH = 1 if serbus error on this bad parity (must halt). 
LH is cleared on CONTINUE or STARTUP. 





CPUl 




CPU2 




CPU3 




CPU4 




CPUS 


Item 


Location 


5 


%CVUPT 


12 


%CVLST 


14 


%CVTPE 



15 



16 



%CVSPE 



%CVMPC 
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Item 
17 



20 



41 
42 



43 



44 



45 



Location 
%CVMPA 



%CVMPW 



21 


%CVMPP 


27 


%CVABC 


30 


%CVABA 


31 


%CVUR 


32-34 




35 


%CVSTS 


36 


%CVRUN 


37 


%CVNUL 


40 


%CVEDI 



%CVJOB 
%CVOHT 



%CVEVM 



%CVEVU 



%CVLLC 



Use 

Memory parity address for this CPU. That is, 
first bad physical memory address found when the 
monitor swept through core after processor or 
channel detected first parity error. 

Memory parity word for this CPU. That is, contents 
of first bad word found by monitor when it swept 
through core after the processor or channel detect- 
ed first bad parity. 

Memory parity PC for this CPU. That is, PC of 

last memory parity (not counting sweep through 

core) . 

Address break count on this CPU. 

Address break address on this CPU . 

Last job run on this CPU including the null job. 

Obsolete. Refer to items 20-23 in the Response 
Subtable. 

Stop timesharing on this CPU. Contains job 
nurr^er which performed the TRPSET UUO. 

Operator-controlled scheduling for this CPU 

(OPSER: SET RUN command). 

Bit (CV%RUN) = 1 do not run jobs on this CPU . 

Null time in jiffies for this CPU. 

LH = exec PC so that offending instruction can be 

corrected. 

RH = number of exec "don't care" interrupts (i.e., 

user enabled APR interrupts which moiitor causes 

(AOV, FOV). 

Current job running on this CPU (0 is null job). 

Overhead time in jiffies for this CPU. Includes 
clock queue processing, short command processing, 
swapping and scheduling decisions, and software 
context switching. Does not include UUO 
execution or \/0 interrupt time, since these times 
are not overhead . 

(KIlO only) Maximum amount of exec virtual address 
space to be used for mapping user segments on a 
LOCK UUO. 

(KIT only) Cun-ent amount of exec virtual address 
space being used for mapping user segments on a 
LOCK UUO. 

On a dual processor system, the count of the number 
of times a CPU has looped in the CPU interlock 
while waiting for it to be relinquished by the 
second CPU. 
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Item 
46 

47 



Location 
%CVTUC 



%CVTJC 



Ue 

Total number of UUOs executed on this CPU from 
exec and user mode. 

Total number of job context switches from one Job 
to a different job, including the null job, on this 
CPU. 



3.6.3.4.13 GETTAB Subtables - Via the GETTAB mechanism, GETTAB subtables make monitor- 
collected data available to user programs and, at the same time, allow the installation to decide 
if it wants to use more monitor toble space without invalidating any user programs. These subtables 
are included in all systems except the DECsystem-1040. However, they may be excluded by changing 
the appropriate conditional assembly switches with MONGEN. It is anticipated that only installations 
that need the core space for other uses will decide to exclude the subtables. 

To reference a subtable, the user program first does a GETTAB UUO to obtain the pointer to the sub- 
table (refer to Paragraph 3.6.3.4. 11). Then the program does a second GETTAB to get the desired 
item in the subtable. If the pointer is zero, the desired subtable is not included in the system. 

The following example illustrates the method for obtaining the accumulated response times for CPU N 
for all users that waited for their jobs to initially run after TTY input was given. 



%CCRSP«»XWD 13,55 
%CVRAI>a3 



;WORD AND TABLE NUMBER FOR RESPONSE SUBTABLE 
?SU9TABLE INDEX FOR ACCUMULATED TTY INPUT UUO 
; RESPONSE. 

/GETTAB TABLE FOR CPU0 VARIABLES 
?CPU NUMBER C0#l,,,.,5) 

/CONSTANTS TABLE GETTAB INOEX MOVES UP BY TkQS, 
/RELATIVE GETTAB POINTER WORD FOR RESPONSE 
/ SUBTABLE FOR CPU0, 
/FORM GETTAB ARGUMENT FOR CPU N, 
/GET RELATIVE POINTER TQ RESPONSE SUBTABLE. 
/NOT THERE (MONITOR IS ONE BEFORE 5,05) 
/IF 0, SUBTABLE NOT INCLUDED IN THIS 
/ LOAD. OF THE MONITOR, 
/FORM DESIRED INDEX IN SUBTABLE WITH 
/ RESPECT TO VARIABLE GETTAB, 
/RELATIVE ADDRESS OF SUBTABLE WITH 
/ RESPECT TO VARIABLE TABLE, 
/FORM PROPER GETTAB FOR CPU VARIABLES. 
/GET RESPONSE TIME, 

/NOT THERE, THIS SHOULD NOT HAPPEN SINCE 
/ ZERO TEST ON RELATIVE POINTER FAILED, 
HERE WITH RESPONSE IN T2 



,GTC0V«»56 

MOVEI Tl,N 

LSH T1,N 

MOVE T2» I%CCRSP3 

ADD T2,Tl 
GETTAB T2, 

JRST NONE 
JUMPE T2,N0NE 

ADOI T2,%CVRAI 

HRL T2,T2 

HRRI T2,,GTC0VCT13 
GETTAB T2, 
JRST NONE 



Response Subtable 

The response subtable is pointed to by %CCRSP in the constants table for each processor. This sub- 
table is under the conditional ass€jmbly switch FTRSP. Refer to Paragraph 3.6.3.4.3 for additional 
response information. 
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Item 




Location 
%CVRSO 



5 
6 

7 

10 



%CVRNO 
%CVRHO 

%CVRLO 

%CVRSI 



%CVRNI 
%CVRHI 

%CVRLI 

%CVRSR 



n 


%CVRNR 


12 


%CVRHR 


13 


%CVRLR 


14 


%CVRSX 


15 


%CVRNX 


16 


%CVRHX 



Use 

Accumulated TTY output UUO responsesT That is, 
the total number of jiffies users have spent waiting 
for their jobs to do a TTY output UUO (on CPUO) 
after either a command was Issued which ran a job 
or terminal Input was given that removed the job 
from a TTY input wait state. 

Number of TTY oufput UUO responses for this CPU. 
The high-order sum of the squares of TTY output UUO 
responses. Used for computing standard deviation. 

The low-order sum of the squares of TTY output UUO 
responses . 

Accumulated TTY Input UUO responses for this CPU. 
That is, the total number of jiffies users have spent 
waiting for their jobs to do a TTY input UUO (on 
CPUO) after either a command was issued which 
ran a job or terminal Input was given that removed 
the job from a TTY input wait state. 

Number of TTY input UUO responses for this CPU. 

The high-order sum of the squares of TTY Input UUO 
responses. Used for computing standard deviation. 

The low -order sum of the squares of TTY input UUO 
responses. 

Accumulated CPU quantum requeue responses. That 
is, total number of jiffies users spent waiting for 
their jobs to exceed the CPU quantum on this CPU 
after either a command was Issued which ran a job 
or terminal input was given that removed the job 
from a TTY input wait state. 

Number of CPU quantum requeue responses for this 
CPU. 

The high-order sum of the squares of CPU quantum 
requeue response. Used for computing standard 
deviation. 

The low-order sum of the squares of CPU quantum 
requeue response. 

Accumulated response terminated by the first 
occurrence of one of the above 3 events (TTY 
output, TTY input, or CPU quantum requeue). 

Number of such responses in %CVRSX. 

The high-order sum of the squares of responses In 
%CVRSX. Used for computing standard deviation. 
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Item 
17 

20 



21 

22 
23 



Location 
%CVRLX 

%CVRSC 



%CVRNC 

%CVRHC 
%CVRLC 



Use 

The low-order sum of the squares of responses in 
%CVRSX. 

Accumulated CPU responses on this CPU. Total 
number of jiffies that users waited for their jobs 
to run after either a command was issued which 
ran a job or terminal input was given that removed 
the job from a TTY input state. 

Number of CPU responses for all users waiting for 

their jobs to run. Dividing this value into the 

value of %CVRSC gives the average response time 

since the system was started. 

The high-order sum of the squares of CPU responses 

on this CPU. 

The low-order sum of the squares of CPU responses 

on this CPU. 



Parity Subtable 

The parity table is pointed to by %CCPAR in the constants table for each processor. This subtable is 
under the conditional assembly switch FTMEMPAR. Refer to Paragraphs 3.6.3.4.3 and 7 J for 
additional parity information. 



Item 




7 

10 

11 

5.06 Monitor 



Location 
%CVPLA 

%CVPMR 

%CVPTS 

%CVPSC 
%CVPUE 

%CVPAA 

%CVPAC 

%CVPOA 

%CVPOC 

%CVPCS 



Use 

Highest bad memory parity address on last sweep of 
memory. Used to tell operator the range of bad 
addresses . 

Relative address (not virtual address) in the high or 
low segment of the last memory parity error. 

Number of parity errors on the last sweep of core. 
Set to at beginning of the sweep. 

Number of parity sweeps by the monitor. 

Number of user-enabled parity errors. Refer to 

Paragraph 3.1 .3.1. 

The AND of bad addresses on the last memory parity 

sweep. 

The AND of bad contents on the last memory parity 

sweep. 

The OR of bad addresses on the last memory parity 

sweep. 

The OR of bad contents on the last memory parity 

sweep. 

Number of spurious parity errors. (The APR sweep 
found no bad parity but the channel had requested 
the sweep rather than the processor). This indicates 
a channel memory port problem. 
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Bad Address Sub table 

The bad address table is pointed to by %CCMPT in the constants table for each processor. This sub- 
table is under the conditional assembly switch FTMEM PAR and contains the bad addresses on the last 
memory parity sweep. It is not cleared and the number of valid entries is kept in %CVPTS in the 
parity subtable. 

3.6.3.4.14 Entries in Table 71 - .GTFET (Feature Table) 

This table provides the user with a mechanism for determining the current settings of all features defined 
in F.MAC 



Item 




Location 
%FTUUO 



%FTRTS 



%FTCOM 



UUOs 



t26= 1 
t27= 1 
UUOs 
t28= 1 
t29= 1 
t30= 1 
t31 = 1 
t32= 1 
t33= 1 
t34= 1 
t35= 1 



Use 

if control-C intercept (F%CCIN). 
if JOBSTS andCTUOB 
are implemented (F%PTYU). 
if PEEK UUO implemented (F%PEEK). 
if POKE. UUO implemented (F%POKE). 
if JOB continue (F%JCON). 
if spooling supported (F%SPL). 
if job privileges supported (F%PRV). 
if DAEMON supported (F%DAEM). 
if GETTAB exists (F%GETT). 
if 2-register relocation (F%2REL). 



Real time and scheduling features 



t27= 1 if swapper (F%SWAP). 
t28= 1 if shuffler (F%SHFL). 
t29= 1 if DK 10 service (F%RTC). 
t 30= 1 if LOCK UUO implemented (P/oLOCK). 
t 31 = 1 if TRPSET UUO implemented (F%TRPS). 
t 32 = 1 if real-time traps implemented (F%RTTR). 
t 33= 1 if SLEEP UUO implemented (P/oSLEE). 
t 34= 1 if HIBER and WAKE UUOs supported 

(F%HIBW). 
t 35= 1 if high priority queues supported (F%HPQ) 



Commands 



t 23 = 1 if COMPIL commands (P/oCCL). 

t24= 1 if COMPIL-class (F%CCLX). 

t25= 1 if QUEUE (F%QCOM). 

t 26 = 1 if SET UUO and command (F%SET). 

t27= 1 if VERSION (P/oVERS). 

t 28= 1 if Batch control file commands (F7oBCOM). 

t 29 = 1 if SET DAYTIME and SET DATE (P/oSEDA). 

t30= 1 if WATCH (F%WATC). 
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Item 



Location 



%FACC 



%FTERR 



%FTDEB 



%FTSTR 



Lke 

Bit 31 = 1 if FINISH and CLOSE (F%FINI). 
Bit 32 = 1 if REASSIGN (F%REAS). 
Bit 33 = 1 if E and D (F%EXAM). 
Bit 34= 1 if SEND (F%TALK). 
Bit 35= 1 if ATTACH (F%ATTA). 

Accounting information 



t 31 = 1 if time and core limits (F%TLIM). 

t 32 = 1 if charge number (F%CNO). 

t 33= 1 if user name (F%UNAM). 

t 34 = 1 if kilo-core-ticks accumulation (F%KCT). 

t 35 = 1 if run-time computation (F%TIME). 



Error conirol and internal options 

Bit 26= 1 if swapping process data block (F%PDBS). 

Bit 27= 1 if KIIO features at startup time (P/oKIlO). 

Bit 28 = 1 if METER. UUO supported (F%METR). 

Bit 29= 1 if execute-only files (F%EXON). 

Bit 30= 1 if illegal instruction message checks for 

for KIIO instructions (F%KII). 
Bit 31 = 1 if code to load BOOTS from disk 

(F%BOOT). 
Bit 32 = 1 if more than one swapping device 

(F%2SWP). 
Bit 33= 1 if DAEMON error logging (F%EL). 
Bit 34 = 1 if multi-processor code loaded (F%MS). 
Bit 35 = 1 if memory parity error recovery 

(F%MEMP). 

Debugging features 

Bit 28 = 1 if response time measurement (F%RSP). 

Bit 29= 1 if why reload code (P/oWHY). 

Bit 30 = 1 if patch space left in tables (P/oPATT). 

Bit 31 = 1 if back -tracking information left in 

COMMON (F%TRAC). 
Bit 32 = 1 if monitcM- halts on en-or (F%HALT). 
Bit 33 = 1 if redundancy checking for internal errors 

(F%RCHK). 



t 34= 1 if monitor write protected (F%MONP). 
t 35 = 1 if monitor check summing (F%CHEC). 

le structure parameters 

t 21 = 1 if NUL device (F%NUL). 

t 22 = 1 if LIB/SYSAJEW (F%LIB). 

t23= 1 if disk priority transfers (F%DPRI). 

t 24 = 1 if append to last block (F%APIB). 

t25= 1 if append implies read (F%AIR). 

t 26 = 1 if generic device search (F%GSRC). 

t27= 1 if rename across directories (F%DRDR). 

t28= 1 if SEEK UUO (F%DSEK). 

t 29 = 1 if super USETI/USETO (F%DSUP). 

t 30 = 1 if disk quotas (F%DQTA). 
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Item 



Location 



%FTDSK 



10 



%FTSCN 



n 



%FTPER 



Use 

t31= 1 if multiple file structures (F%STR). 
t 32 = 1 if 5-series UUOs (F%5UUO). 
t33=,l if physical-only I/O (F%PHYO). 
t34= 1 if sub-file directories (F%SFD). 
t35= 1 if STRUUO functions (F%MOUN)o 



Internal disk parameters 



t21 = 1 if DEBUG CB interlock (F%CBDB) 

t 22 = 1 if LOGIN system (F%LOGI). 

t23= 1 if disk system (F%DISK). 

t 24 = 1 if race -condition prevention in FILFND 

(F%FFRE). 

t 25 =■ 1 if swap read error recovery (F%SWPE). 

t 26 = 1 if bad block marking (F%DBBK). 

t 27 = 1 if UFD compressor (P/oDUFC) . 

t28= 1 if disk error simulation (F%DETS). 

t 29 = 1 if extended RIBs supported (F%DMRB). 

t 30 = 1 if smaller allocation for disk core blocks 

(F%DSMC). 
t 31 = 1 if allocation optimization (F%DALC). 
t 32 = 1 if disk usage statistics (F%DSTT). 
t 33 = 1 if hung disk recovery (P/oDHNG). 
t 34= 1 if disk off-line recovery (P/oDBAD). 
t 35 = 1 if latency optimization (F%DOPT). 



Scanner options 

Bit 27= 1 if TTY BLANK command (P/oTBLK). 

Bit 28 = 1 if page and display knowledge 

(F%TPAG). 
Bit 29 =1 if automatic dialer supported (F%DTAL). 
Bit 30= 1 if special line control (P/oSCLC). 
Bit 31 = 1 if hardware (DC 10 or DC68) scanner 

(F%SCNR). 
Bit 32 = 1 if modem control (F%MODM). 
Bit 33 = 1 if single scanner 630 (P/o630H). 
Bit 34= 1 if U.K. modem supported (F%GP02), 
Bit 35= 1 if real half-duplex terminals (F%HDPX). 

I/O Parameters 



t27= 1 ifCDP trouble intercept (P/qCPTR). 

t28= 1 if CDR trouble intercept (F%CRTR). 

t29= 1 if CTYl supported (P/oCTYl). 

t 30= 1 if remote station supported (F%REM). 

t 31 = 1 if LPT en-or recovery (F%LPTR). 

t 32 = 1 if device errors to operator (F%OPRE). 

t33= 1 if CDR super-image mode (F%CDRS). 

t 34= 1 if MTA density and buffer size (P/oMTSE). 

t 35 = lif TMPCOR area (F%TMP). 
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3.6,4 Configuration Informat'ion 

3.6.4. 1 SWITCH AC, or CALL! AC, 20 - This UUO returns the contents of the central processor 
data switches in AC. Caution must be exercised in using the data switches because they are not an 
allocated resource and are always available to all users. 

3.6.4.2 LIGHTS AC, or CALLI AC, -1 - This UUO displays the contents of AC in the console 
lights. 

3.7 DAEMON AC, OR CALLI AC, 102^ 

This UUO requests the DAEMON program to perform a specified function for the user program. The 

call is: 

MOVE AC, [XWD length (n+1), ADR] 

DAEMON AC, ;or CALLI AC, 102 

error return 

normal return 

ADR: function 
org! 
arg2 

arg^ 

The length of the argument list can be zero if the number of arguments is fixed. The first word of the 
argument list is the code for the requested function. Non-privileged functions of the DAEMON UUO 
are presented in the following paragraphs. Refer to the Specifications section of the DECsystem-10 
Software Notebooks for a description of the privileged functions. 

3.7.1 .DC ORE Function 

This function causes DAEMON to write a dump file of the \ch's core area. The call is: 

ADR: 1 ;.DCORE function 

SiXBIT/dev/ 
SIXBIT/file/ 
SIXBIT/ext/ 


XWD ppn 
SIXBIT/SFDl/ 

SIXBIT/SFDN/ 



l-r. . 



This UUO depends on FTDAEM which is normally off in the DECsystem- 1040. 
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If an argument is omitted, the default is the same as in the DC ORE command (refer to DECsystem-10 
Operqting System Commands) . 

3.7.2 .CLOCK Function 

This function causes DAEMON to enter a request in the clock queue in order to wake the job after the 
specified number of seconds has elapsedo The UUO returns as soon as the request is entered. The 
HIBER UUO with no clock request (refer to Paragraph 3. 1.4,2) should then be used to place the job 
in the sleep queue. 

The call is: 



MOVEI AC, BLOCK 




DAEMON AC, 




JRST ERROR 




SETZ AC, 




HIBER AC, 




JRST ERROR 




ERROR: ... 


;simulate the DAEMON UUO 




; with the SLEEP UUO. 


BLOCK: 2 


;. CLOCK function 


+seconds 


;number of seconds to sleep. 



If the job already has a request in the clock queue, the new request supersedes the current request. 
Thus, jobs desiring to be awakened several times should issue one request for the soonest wake time. 

There is no maximum on the amount of time a job can sleep and therefore, this UUO is useful when a 
sleep time of more than 63 seconds is desired (the SLEEP and HIBER UUOs have an implied maximum of 
63 seconds). A request specifying seconds clears the job's entry in the clock queue and immediately 
wakes the job. Note that the resolution of the timer may be several seconds slow if the system is 
heavily loaded. 

3.7.3 Returns 

The error return is given if the UUO is not implemented, DAEMON is not running, or DAEMON can- 
not complete the requested function. If the UUO is not implemented or DAEMON is not running, AC 
remains unchanged. If DAEMON cannot complete the request, AC contains one of the following error 
codes: 

Illegal function . 



1 DMILP/o 

2 DMACK% 

3 DMWNA% 

4 DMSNH% 



Address check. The argument block is outside of 
user core or in the job data area. 

Wrong number of arguments. 

Impossible UUO failure (should never happen). 



(Cont on next page) 
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5 DMCWP/o Cannot wrife file. An OPEN or I NIT failed. 

6 DMNPV% No privileges. An attempt was made to write 

in the accounting files without having the proper 
privileges. 

7 DMFFB% FACT format is bad. 
10 DMPTH% Invalid path specification. 

The normal return is token if the requested function is successfully completed. 
3.8 REAL-TIME PROGRAMMING 

3.8.1 RTTRP AC, or CALLI AC, 57^ 

The real-time trapping UUO is used by timesharing users to dynamically connect real-time devices to 
the privity interrupt system, to respond to these devices at interrupt level, to remove the devices 
from the interrupt system, and to change the PI level on which the devices are associated. The 
RTTRP UUO can be called from UUO level or from interrupt level. This is a privileged UUO that 
requires the job to have real -time privileges (granted by LOGIN) and to be locked in core (accom- 
plished by LOCK UUO). These real-time privileges are assigned by the system manager and obtained 
by the monitor from ACCT. SYS. The privilege bits required are: 

1) JP.LCK (Bit 14) - allows the job to be locked in core. 

2) JP.RTT (Bit 13) - allows the RTTRP UUO to be executed. 

WARNING 

Improper use of features of the RTTRP UUO can cause the 
system to fail in a number of ways. Since design goals of 
this UUO were to give the user as much flexibility as 
possible, some system integrity had to be sacrificed. The 
most common errors are protected against since user pro- 
grams run in user mode with all ACs saved. It is recom- 
mended that debugging of real-time programs not be done 
when system integrity is important. However, once these 
programs are debugged, they con run simultaneously with 
batch and timesharing programs. 

Real-time jobs control devices one of two ways: block mode or single mode. In block mode, an en- 
tire block of data is read before the user's interrupt program is run. In single mode, the user's interrupt 
program is run every time the device interrupts. Furthermore, there are two types of block mode: 
fast block mode and normal block mode. These differ in response times. The response time to read a 
block of data in fast block mode is 6.5 jjs per word and in normal block mode, 14.6 ps per word. 
(This is the CPU time to complete each data transfer.) In all modes, the response time measured from 
the receipt of the real-time device interrupt to the start of the user control program is 100 ps. 



This UUO depends on FTRTTRP which is normally off in the DECsystem-1040. 
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The RTTRP UUO allows a real-time fob to either put a BLKI or BLKO instruction directly on a PI 
level (block mode) or add a device fro the front of the monitor PI channel CONSO skip chain (single 
mode). Since the BLKI and BLKO are executed in exec mode, a KllO-bosed system requires that the 
job be mapped in exec virtual memory, in addition to being locked (refer to the LCXIK UUO). When 
an inten-upt occurs from the real-time device in single mode or at the end of a block of data in block 
mode, the monitor saves the current state of the machine, sets the new user virtual memory and APR 
flags, and traps to the user's interrupt routine. The user services his device and then returns control 
to the monitor to restore the previous state of the machine and to dismiss the interrupt. 



In feet block mode the monitor places the BLKI/BLKO instruction directly in the PI trap location fol- 
lowed by a JSR to the context switcher. This actiai requires that the PI channel be dedicated to the 
real-time job during any transfers. In normal block mode the monitor places the BLKI/BLKO instruc- 
tion directly after the real-time device's CONSO instruction in the CONSO skip chain (refer to 
Chapter 7) . 

Any number of real-time devices using either single mode or normal block mode can be placed on any 
available PI channel. The average extra overhead for each real-time device on the same channel is 
5.5 jjs per interrupt. 
The call is; 



MOVEI AC, RTBLK 
RHRP AC, 
error return 
normal return 



; AC contains address of data block. 

;or CALLI AC, 57, put device on PI level . 

;AC contains an error code . 

;PI is set up properly. 

The data block depends on the mode used. In single mode the data block is: 

RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 
CONSO DEV, BITS 



;PI channel (1-6) and trap address. 
;APR trap address . 
;CONSO chain instruction. 
;no BLKI/bLKO instruction. 



The data block in fast block mode is: 

RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 
BLKO DEV, BLKADR 




The data block in normal block mode is; 
RTBLK: XWD PICHL, TRPADR 

EXP APRTRP 

CONSO DEV, @BITMSK 
BLKI DEV, BLKADR 



;PI and trap address when BLKO done. 
;APR trap address. 
;BLKI or BLKO instruction. 
;BLKADR points to the lOWD of 
;blodk to be sent. 



channel and trap address. 
APR trap address . 
control bit mask from user area. 
BLKI inslruction. 
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On multiprocessor systems, the real-time trap UUO applies only to the processor specified by the fob's 
CPU specification (refer to the SET CPU command or the SET UUO). If the specification indicates 
more thai one processor, the specification is changed to indicate CPUO. Note that the PI channel 
(PICHL) and processor traps (APRTRP) are only for the indicated CPU. 

3.8.1 .1 Data Block Mnemonics - The following mnemonics are used in describing the data block 
associated with the RTTRP UUO. 

PICHL - PICHL is the PI level on which the device is to be placed. Levels 1-6 are legal depending 
on the system configuration. If PICHL = 0, the device is removed from all levels. When a device is 
placed on a PI level, normally all other occurrences of the device on any PI level are removed. If 
the user desires the same device on more than one PI level simultaneously (i.e., a data level and an 
en-or level), he can issue the RTTRP UUO with PICHL negative. This indicates to the system that any 
other occurrence of this device (on any PI level) is not to be removed. Note that this addition to a 
PI level counts as a real-time device, occupying one of the possible real-time device slots. 

TRPADR - TRPADR is the location trapped to by the real-time inten-upt (JRST TRPADR). Before the 
trap occurs, all ACs are saved by the monitor and can be overwritten without concern for their con- 
tents. 

APRTRP - APRTRP is the trap location for all APR traps. When an APR trap occurs, the monitor 
simulates a JSR APRTRP. The user gains control from an APR trap on the same PI level that his real- 
time device is on. The monitor always traps to the user program on illegal memory references, non- 
existent memory references, and push-down overflows. This allows the user to properly turn off 
his real-time device if needed. The monitor also traps on the conditions specified by the APRENB 
UUO (see Paragraph 3.1 .3.1). No APR errors are detected if the interrupt routine is on a PI level 
higher than or equal to the APR interrupt level . 

DEV - DEV is a real-time device code. 

BITS ~ BITS is the bit mask of all interrupt bits of the real-time device and must not contain any other 
bits. If the user desires control of this bit mask from his user area, he may specify one level of in- 
direction in the CONSO instruction (no indexing), i.e., CONSO DEV, @ MASK where MASK is 
the location in the user area of the bit mask. MASK must not have any bits set in the indirect or 
index fields. 

BLKADR - BLKADR is the address in the user's area of the BLKI/BLKO pointer word. Before returning 
to the user, the monitor adds the proper relocation factor to the right half of the pointer word. Data 
can only be read into the low segment above the protected job data area, i .e., above location 1 14. 
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Since the pointer word is in the user's area, the user can set up a new pointer word when the word 
count goes to at interrupt level. This allows fast switching between buffers. When the user desires 
to set up his own pointer word, the right half of the word must be set as en exec virtual instead of a 
user virtual address. The job's relocation value is returned from both the LOCK UUO and the first 
RTTRP UUO executed far setting the BLKI/feLKO instruction . If this pointer word does not contain a 
legal address, a portion of the system might be overwritten . A check should be made to determine if 
the negative word count in the left half of the pointer word is too large. If the word count extends 
beyond the user's own area, the device may cause a non-existent memory interrupt, or may overwrite 
a timesharing job. If all of the above precautions are taken, this method of setting up the pointer 
word is much faster and more flexible than issuing the RTTRP UUO at interrupt level. 

3.8.1 .2 Interrupt Level Use of RTTRP - The format of the RTTRP UUO at intenrupt level is similar 
to the format at user level except for two restrictions: 

1) AC 16 and AC 17 cannot be used in the UUO call (i.e., CALLl 16, 57 is 
illegal at interrupt level). 

2) All ACs are overwritten when the UUO is executed at interrupt level. There- 
fore, the user must save any desired ACs before issuing the RTTRP UUO. This 
restriction is used to save time at interrupt level. 

CAUTION 

If an interrupt level routine executes a RTTRP UUO that 
affects the device currently being serviced, no additional 
UUOs of any kind (including RTTRP) can be executed dur- 
ing the remainder of the interrupt. At this point, any sub- 
sequent UUO dismisses the interrupt. 

3.8.1 .3 RTTRP Returns - On a normal return, the job is given user lOT privileges. These privileges 
allow the user to execute all restricted instructions including the necessary I/O instructions to con- 
trol his device. 

The lOT privilege must be used with caution because improper use of the I/O instructions could halt 
the system (I.e., HALT on the KAIO; CO NO APR, 0; DATAO APR, 0; CO NO PI, on the KAIO 
and KIlO; and CONO PAG, or DATAO PAG, on the KIlO). Note that a user can obtain just 
the user lOT privilege by issuing the RTTRP UUO with PICHL = 0. 

An error return is not given to the user until RTTRP scans the entire data block to find as many errors 
as possible. On return, AC may contain the following error codes. 



3-63 March 1973 



MONITOR CALLS 



-^48- 



Name 
I RTJNP% 
RTCPU% 



Code 
BI1-24=1 
Bit 25=1 



Volue 

4000 

2000 





RTDIU% 


Bit 26=1 


1000 




RTIAU% 


Bit 27=1 


400 


1 


RTJNL% 


Bit 28=1 


200 




RTSLE% 


Bit 2S^1 


100 




RTILF% 


Bit 30=1 


40 




RTPWI% 


Bit 31=1 


20 




RTEAB% 


Bit 32=1 


10 




RTTAB% 


Bit 33=1 


4 




RTPNB% 


Bit 34=1 


2 




RTPNA% 


Bit 35=1 


1 



Meaning 

Job not privileged. 

Not permitted on CPUl . (This is a temporary error 
condition reflecting the fact that the initial release 
of the 5.05 monitor will not support the RTTRP UUO 
on CPUl). 

Device already in use by another job. 

Illegal AC used during RTTRP UUO at interrupt level. 

Job not locked in core. 

System limit for real-time devices exceeded. 

Illegal format of CONSO, BLKO, or BLKI instructiofi 

BLKADR or pointer word illegal. 

Error address out of bounds. 

Trap address out of bounds. 

PI channel not currently available for BLKI/^LKO's. 

PI channel not available (restricted use by system). 



3.8.1.4 Restrictions - 



1) Devices may be chained onto any PI channel that is not used for BLKl/BLKO in- 
structions by the system or by other real-time users using fast block mode. This 
includes the APR channel. Normally PI levels 1 and 2 are reserved by the 
system for magnetic tapes and DECtapes. PI level 7 is always reserved for the 
system . 

2) Each device must be chained onto a PI level before the user program issues the 
CONO DEV, PIA to set the device onto the interrupt level. Failure to observe 
this rule or failure to set the device on the same PI level that was specified in 
the RTTCP UUO could hang the system. 

3) If the CONSO bit mask is set up and one of the corresponding flags in a device 
is on, but the device has not been physically put on its proper PI level, a trap 
may occur to the user's interrupt service routine. This occurs because there is 

a CONSO skip chain for each PI level, and if another device interrupts whose 
CONSO instruction is further down the chain than that of the real-time device, 
the CONSO associated with the real-time device is executed. If one of the 
hardware device flags is set and the corresponding bit in the CONSO bit mcsk 
is set, the CONSO skips and a trap occurs to the user program even though the 
real-time device was not causing the interrupt on that channel. To avoid this 
situation the user can keep the CONSO bit mask in his user area (refer to 
Paragraph 3.8.1 .1). This procedure allows the user to chain a device onto the 
interrupt level, keeping the CONSO bit mask zero until the device is actually 
put on the proper PI level with a CONO instruction. This situation never 
arises if the device flags are turned off until the CONO DEV, PIA can be 
executed . 
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4) The user should guard against putting programs on high priority interrupt levels 
which execute for long periods of time. These programs could cause real-time 
programs at lower levels to lose data. 

5) The user program must not change any locations in the protected job data area 
(locations 20-114), because the user is running at interrupt level and full con- 
text switching is not performed. 

6) If the user is using the BLKI/BLKO feature, he must restore the BLKI/BLKO 
pointer word before dismissing any end-of-block interrupts. This is accom- 
plished with another RTTRP UUO or by directly modifying the absolute pointer 
word supplied by the first RTTRP UUO. Failure to reset the pointer word 
could cause the device to overwrite all of memory. 

3.8.1 .5 Removing Devices from a PI Channel - When PICHL=0 in the data block (see Paragraph 
3.8.1 .1), the device specified in the CONSO instruction is removed from the interrupt system. If 
the user removes a device from a PI chain, he must also remove the device from the PI level (CONO 
DEV, 0). 

A RESET/ EXIT, or RUN UUO from the timesharing levels removes all devices from the inten-upt levels 
(see Paragraph 3.2.2.4). These UUOs cause a CONO DEV, to be executed before the device is 
removed. Monitor commands that issue implicit RESETS also remove real-time devices (e.g., R, RUN, 
GET, CORE 0, SAVE, SSAVE). 

3.8.1 .6 Dismissing the Inten-upt - The user program must always dismiss the interrupt in order to al- 
low monitor to properly restore the state of the machine. The inten-upt may be dismissed with any 
UUO other than the RTTRP UUO or, on the KAIO, any instruction that traps to absolute location 60. 
The standard method of dismissing the interrupt is with a UJEN instruction (op code 100). This 
instruction gives the fastest possible dismissal. 

3.8.1.7 Examples 

********** EXAMPLE 1 ****♦♦**** 
SINGLE MODE 

TITLE RTSNGL - PAPER TAPE READ TEST USING CONSO CHAIN 

PIOFF=400 5TURN PI SYSTEM OFF 

PION=200 ^TURN PI SYSTEM ON 

TAPE-400 i NO MORE TAPE IN READER IF TAPE=0 

BUSY=20 IDEVICE IS BUSY READING 

DONEsie 'A CHARACTER HAS BEEN READ 

PDATA: Z ILOCATION where data is READ INTO 
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PTRTSTi 


I RESET 




MOVE CXWD 1,1] 




LOCK 




JRST FAILED 




SETZM PTRCSO 




SETZM DONFLG 




MOVE I RTBLK 




RTTRP 




JRST FAILED 




MOVE I 1,D0NE 




HLRZ 2*RTBLK 




TRO 2#BUSY 




CONO PI*PIOFF 




MOVEM 1, PTRCSO 




CONO PTR,<2) 




CONO PI,PION 




MOVEI 5 




SLEEP 




SKIPN DONFLG 




JRST .-3 




EXIT 


RTBLK: 


XWD 5>TRPADR 




EXP APRTRP 




CONSO PTR,©PTRC 




Z 


PTRCSO: 


z 


DONFLG: 


z 


RTBLKl : 


z 




z 




CONSO PTR,0 




z 


TRPADR: 


CONSO PTR^TAPE 




JRST TDONE 




DATAI PTR*PDATA 




UJEN 


APRTRP: 


Z 


TDONE: 


MOVEI RTBLKl 




CONO PTR,0 




RTTRP 




JFCL 




SETOM DONFLG 




SETZM PTRCSO 




UJEN 



PRESET THE PROGRAM 

ILOCK BOTH HIGH AND LOW SEGMENTS 

iLOCK THE JOB IN CORE 

J LOCK UUO FAILED 

IMAKE SURE CONSO BITS ARE ZERO 

UNITIALIZE DONE FLAG 

iGET ADDRESS OF REAL TIME DATA BLOCK 

iPUT REAL TIME DEVICE ON THE PI LEVEL 

IRTTRP UUO FAILED 

JSET UP CONSO BIT MASK 

I GET PI NUMBER FROM RTBLK 

JSET UP CONO BITS TO START TAPE GOING 

JGUARD AGAINST ANY INTERRUPTS 

iSTORE CONSO BIT MASK 

JTURN PTR ON 

J ALLOW INTERRUPTS AGAIN 

iSET UP TO SLEEP FOR 5 SECONDS 

JHAVE WE FINISHED READING THE TAPE 
iNO GO BACK TO SLEEP 



iPl CHANNEL AND TRAP ADDRESS 

j apr error trap address 

* indirect conso bit mask = ptrcso 

;no blki/o instruction 

iCONSO BIT MASK 

IPI LEVEL TO USER LEVEL COMM. 
iDATA BLOCK TO REMOVE PTR 
iFROM PI CHANNEL 



lEND OF TAPE? 
iYES* GO STOP JOB 
;READ in DATA WORD 
^DISMISS THE INTERRUPT 

JAPR ERROR TRAP ADDRESS 

SSET UP TO REMOVE PTR 

;TAKE DEVICE OFF HARDWARE PI LEVEL 

;REMOVE FROM SOFTWARE PI LEVEL 

1 IGNORE ERRORS 

iMARK THAT READ IS OVER 

;CLEAR CONSO BIT MASK 

JDISMISS THE INTERRUPT 



FAILED: TTCALL 3* [ASC IZ/RTTRP UUO FAILED!/] 
EXIT 

END PTRTST 
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TAPES 
BUSY =20 
DONE=10 
BLKTST: RESET 



RTBLK: 



POINTR! 

OPOINT! 

TABLE: 

DONFLG: 

RTBLKl 



^^it:it::H^*i^:^* EXAMPLE 2 ********** 

FAST BLOCK f^ODE 

TITLE RTFBLK - PAPER TAPE READ TEST IN BLKI MODE 

iNO MORE TAPE IN READER IF TAPE=0 

^DEVICE IS BUSY READING 

5 A CHARACTER HAS BEEN READ 

iRESET THE PROGRAM 

5L0CK BOTH HIGH AND LOW SEGMENTS 

5L0CK THE JOB IN CORE 

JLOCK UUO FAILED 

UNITIALIZE DONE FLAG 

J GET ADDRESS OF REAL TIME DATA BLOCK 

;PUT REAL TIME DEVICE ON THE PI LEVEL 

JRTTTP UUO FAILED 

;GET pi NUMBER FROM RTBLK 

;SET UP CONO BITS TO START TAPE GOING 

5TURN PTR ON 

iSET UP TO SLEEP FOR 5 SECONDS 

iHAVE WE FINISHED READING THE TAPE 
iNO GO BACK TO SLEEP 



MOVE CXWD IjI] 

LOCK 

JRST FAILED 

SETZM DONFLG 

MOVE I RTBLK 

RTTRP 

JRST FAILED 

HLRZ 2*RTBLK 

TRO 2*BUSY 

CONO PTR* (2) 

MOVE I 5 

SLEEP 

SKIPN DONFLG 

JRST .-3 

EXIT 

XWD 6>TRPADR 
EXP APRTRP 
BLKI PTR*POINTR 
Z 

lOWD 5#TABLE 

lOWD 5# TABLE 

BLOCK 5 

Z 

Z 

Z 

CONSO PTR#0 

Z 



IP I CHANNEL AND TRAP ADDRESS 
tAPR ERROR TRAP ADDRESS 
5READ A BLOCK AT A TIME 



IPOINTER FOR BLKI INSTRUCTION 
lORIGINAL POINTER WORD FOR BLKI 
STABLE AREA FOR DATA BEING READ 
5PI LEVEL TO USER LEVEL COMM. 
5DATA BLOCK TO REMOVE PTR 
IFROM PI CHANNEL 



TRPADR: CONSO PTR^TAPE 
JRST TDONE 
MOVE OPOINT 
MOVEM POINTR 
UJEN 



APRTRP: 


Z 


TDONE: 


MOVEI RTBLKl 




CONO PTR*0 




RTTRP 




JFCL 




SETOM DONFLG 




UJEN 



5END OF TAPE? 

I YES* GO STOP JOB 

iGET ORIGINAL POINTER WORD 

;REST0RE BLKI POINTER WORD 

^DISMISS THE INTERRUPT 

lAPR ERROR TRAP ADDRESS 

ISET UP TO REMOVE PTR 

iTAKE DEVICE OFF HARDWARE PI LEVEL 

JREMOVE FROM SOFTWARE PI LEVEL 

i IGNORE ERRORS 

I MARK THAT READ IS OVER 

JDISMISS THE INTERRUPT 



FAILED: TTCALL 3* CASC IZ/RTTRP UUO FAILED! /3 
EXIT 

END BLKTST 
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4c]|cj|c4:3»(***4'* EXAMPLE 3 ****♦*♦*♦* 
NORMAL BLOCK MODE 

TITLE RTNBLK - PAPER TAPE READ TEST IN BLKI MODE 



TAPE=400 

BUSYS20 

DONE=10 

BLKTST: RESET 

MOVE CXWD 1»13 

LOCK 

JRST FAILED 

MOVEI RTBLKl 

RTTRP 

JRST FAILED 

CONO PTR*0 

SETZM DONFLG 

MOVEI RTBLK 

RTTRP 

JRST FAILED 

MOVE POINTR 

MOVEM OPOINT 

HLRZ 2*RTBLK 

TRO 2*BUSY 

CONO PTR,<2) 

MOVEI 5 

SLEEP 

SKIPN DONFLG 

JRST .-3 

EXIT 

RTBLK: XWD 6#TRPADR 
EXP APRTRP 
CONSO PTR*DONE 
BLKI PTR*POINTR 



POINTR: 


lOWD 5* TABLE 


OPOINT: 


Z 


TABLE: 


BLOCK 5 


DONFLG: 


Z 


RTBLKl : 


Z 




z 




CONSO PTR*0 




z 


TRPADR: 


CONSO PTR*TAPE 




JRST TDONE 




MOVE OPOINT 




MOVEM POINTR 




UJEN 


APRTRP: 


Z 


TDONE: 


MOVEI RTBLKl 




CONO PTR*0 




RTTRP 




JFCL 




SETOM DONFLG 




UJEN 



iNO MORE TAPE IN READER IF TAPE=0 
^DEVICE IS BUSY READING 
ik CHARACTER HAS BEEN READ 

ilO RESET 

ILOCK BOTH HIGH AND LOW SEGMENTS 

iLOCK THE JOB IN CORE 

5L0CK UUO FAILED 

5GET ADDRESS OF REAL TIME BLOCK 

iGET USER lOT PRIVILEGE 

iUUO FAILED! 

JCLEAR ALL PTR FLAGS 

i INITIALIZE DONE FLAG 

iGET ADDRESS OF REAL TIME DATA BLOCK 

;PUT REAL TIME DEVICE ON THE PI LEVEL 

5RTTRP UUO FAILED 

JGET RELOCATED POINTER WORD FOR LATER 

;STORE FOR INTERRUPT LEVEL USE 

iGET PI NUMBER FROM RTBLK 

5 SET UP CONO BITS TO START TAPE GOING 

iTURN PTR ON 

JSET UP TO SLEEP FOR 5 SECONDS 

JHAVE WE FINISHED KEADING THE TAPE 
5N0 GO BACK TO SLEEP 



iPI CHANNEL AND TRAP ADDRESS 
lAPR ERROR TRAP ADDRESS 
5 WAIT ONLY FOR DONE FLAG 
IREAD A BLOCK AT A TIME 

5P0INTER FOR BLKI INSTRUCTION 

JTABLE AREA FOR DATA BEING READ 
JPI LEVEL TO USER LEVEL COMM. 
iDATA BLOCK TO REMOVE PTR 
iFROM PI CHANNEL 



5END OF TAPE? 

J YES* GO STOP JOB 

iGET ORIGINAL POINTER LOCATION 

5ST0RE IN POINTER LOCATION 

^DISMISS THE INTERRUPT 

5APR ERROR TRAP ADDRESS 

;SET UP TO REMOVE PTR 

iTAKE DEVICE OFF HARDWARE PI LEVEL 

^REMOVE FROM SOFTWARE PI LEVEL 

i IGNORE ERRORS 

iMARK THAT READ IS OVER 

^DISMISS THE INTERRUPT 



FAILED: TTCALL 3* CASC I Z/RTTRP UUO FAILED!/] 
EXIT 

END BKJTST 
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3.8.2 RTTRP Executive Mode Trapping 



In special cases, the real-time user requires a faster response time than that offered by the RTTRP UUO 
when executed in user mode. To accommodate these cases, the user can specify a special status bit in 
the RTTRP UUO call, which gives the program control in exec mode (refer to Paragraph 2.1.3). Exec- 
mode trapping gives response times of less than 10 |js to real-time interrupts. To use this exec-mode 
trapping, the job must have real-time privileges (granted by LOGIN) and be locked in core (occom- 
I plished by the LOCK UUO). On KllO-based systems, the \<h must also be mapped contiguously in 
exec virtual memory (refer to the LOCK UUO). The privilege bits required are: 

1) JP.TRP(Bit 15) 

2) JP.LCK (Bit 14) 

3) JP.RTT(Bit 13) 

Several restrictions must be placed on user programs in order to achieve this level of response. On 

receipt of an interrupt, program control is transferred to the user's real-time program without saving 

ACs and with the processor in exec mode. Therefore, the user program must save and restore all ACs 

that are used, must not execute any UUOs, and cannot leave exec mode. This means that the programs 

must be self-relocating (i.e., through the use of an index or base register). 

CAUTION 

Improper use of the exec mode feature of the RTTRP UUO 
can cause the system to fail in a number of ways. Un- 
like the user mode feature of RTTRP, enrors are not pro- 
tected c^ainst since the programs run in exec mode with 
no ACs saved . 

To specify RTTRP exec-mode trapping, bit 17 of the second word in the data block (RTBLK) must be 
set to 1 . This implies that no context switching is to be done and that a JSR TRPADR is to be used to 
enter the user's real-time interrupt routine. The user program must save and restore all ACs and should 
dismiss the interrupt with a JRSTF @ TRPADR. This instruction must be set up prior to the start of the 
real-time device as an absolute or unrelocated instruction. This can be done because the LOCK UUO 
returns the absolute addresses of the low and high segments after the job is locked in a fixed place 
in memory. 

The exec-mode trapping feature can be used with any of the standard forms of the RTTRP UUO: single 
mode, normal block mode, and fast block mode. 
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3.8.2.1 Example 

TITLE RTEXEC 



./|5Z|- 



RTEXEC 



SLEEP : 



PIA = 5 

DONE=10 

BUSY=e0 

TAPE=400 

1 = 1 

AC =2 

OPDEF HIBERNATE tCALLI 72] 



RESET 

SETZM DONFLG 
MOVE AC^CXWD 1> 1 3 
LOCK AC* 



JRST FAILED 
HRRZS AC 
LSH AC*9 
MOVEM AC* INDEX 

ADDM AC*EXCHWD 
ADDM AC*JENWD 
MOVE I AC*RTBLK 
RTTRP AC* 
JRST FAILED 
CONO PTR*20+PIA 
MOVEI AC*tD1000 
HIBERNATE AC* 
JRST FAILED 
SKIPN DONFLG 
JRST SLEEP 
EXIT 



IRESET THE PROGRAM 
UNITIALIZE THE DONE FLAG 

JLOCK THE JOB IN CORE 

;ABS0LUTE ADDRESS OF JOB IS RETURNED 

I IN AC 

TERROR RETURN 

JGET ONLY LOW SEGMENT ADDRESS 

i JUSTIFY ADDRESS 

isave base address for use at interrupt 
;level 

;REL0CATE INTERRUPT LEVEL PROGRAM 

^RELOCATE RETURN INSTRUCTION 

^CONNECT REAL TIME DEVICE 

JTO THE PI SYSTEM 

JRTTRP UUO FAILED 

JSTART real TIME DEVICE READING 

iSLEEP 

;F0R 10 MILLISECONDS 

i FA I LED 

US THE INTERRUPT LEVEL PROGRAM DONE 

iNO* GO BACK TO SLEEP 

iYES* EXIT 



RTBLKI 


XWD PIA*TRPADR 
XWD 1 APRTRP 
CONSO TR,DONE 



Tl^PADR : 
EXCHWD: 

return: 

JENWD: 




EXCH I* INDEX 
CONSO PTR*TAPE 
JRST TDONECI) 
DATA! PTR*PDATA(I> 
EXCH I*INDEX<I> 
JRSTF ©TRPADR 


APRJRP: 
TDONE : 




CONO PTR,0 
SETOM DONFLGCI) 
JRST RETURNCI) 


FAILED: 


TTCALL 3*tASCIZ/UU 
EXIT 


DONFLG: 
PDATA : 
INCEX: 









END RTEXEC 



JBIT 17 SAYS TRAP IN EXEC MODE 



iJSR TRPADR IS DONE UPON INTERRUPT 

iSET UP INDEX REGISTER 

ITAPE FINISHED? 

iYES* STOP THE READER 

INO* READ IN THE NEXT CHARACTER 

;REST0RE AC'S USED 

JDISMISS THE INTERRUPT 

JAPR ERRORS WILL TRAP HERE 
iTAKE THE READER OFF LINE 
5MARK THAT THE TAPE IS FINISHED 
iGO DISMISS THE INTERRUPT 



;FLAG to specify END OF JOB 

iDATA WORD 

iBASE INDEX REGISTER 
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3.8.3 TRPSET AC, or CALLI AC, 25^ 

The TRPSET feature may be used to guarantee some of the fast response requirements of real-time users. 
In order to achieve fast response to interrupts, this feature temporarily Suspends the running of other 
jobs during its use. This limits the class of problems to be solved to cases where the user wants to 
transfer data in short bursts at predefined times. Therefore, because the data transfers are short, the 
time during which timesharing is stopped is also short, and the pause probably will not be noticed by 
the timesharing users. 

The TRPSET UUO allows the user program to gain control of the interrupt locations. If the user does 
not have the TRPSET privileges (JP.TRP, bit 15), an en-or return to the next location after the CALLI 
is always given, and the user remains in user mode. Timesharing is turned back on. If the user has 
the TRPSET privileges, the central processor is placed in user I/O mode. If AC contains zero, time- 
sharing is turned on if it was turned off. If the LH of AC is within the range 40 through 57 of the 
central processor, all other jobs are stopped from being scheduled and the specified executive PI lo- 
cation (40-57) is patched to trap directly to the user. In this case, the monitor moves the contents 
of the relative location specified in the right half of AC, converts the user virtual address to the 
equivalent exec virtual address, and stores the address in the specified executive PI location. On a 
KllO-based system, this requires that the user segment accessed during the interrupt be locked and 
I mapped contiguously in the exec virtual memory (refer to the LOCK UUO). If the segment does not 
meet these requirements, the error return is given. 

On a multiprocessor system, the TRPSET UUO applies to the processor specified by the job's CPU 
specification (refer to the SET CPU command or the SET UUO). If the specification indicates only 
CPU!, an error return is given if the job is not locked in core. When the specification indicates 
more than one processor, the specification is changed to indicate CPUO (the master processor). 

Thus, the user can set up a priority interrupt trap into his relocated core area. On a normal return, 
AC contains the previous contents of the address specified by LH of AC, so that the user program may 
restore the original contents of the PI location when the user is through using this UUO. If the LH of 
AC is not within the range 40 through 57, an error return is given just as if the user did not have the 
privileges. The basic call is: 

MOVE AC*CXWD N* ADR 3 
TRPSET AC* 
ERROR R|:TURN 
NORMAL RETURN 

• 

Anp. *ic;r trap ;Instruction to be Stored 

ADR . JSR TRAP ..^ ^^^^ pj location 

;after relocation added to it. 
;Here on interrupt from exec. 
TRAP: ' ^ 



Hhis UUO depends on FTTRPSET which is normally off in the DECsystem-1040. 
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The monifor assumes that user ADR contains either a JSR U or BLKI U, where U is a user virtual 
address; consequently, the monitor adds a relocation to the contents of location U to make it an 
absolute lOWD (i.e., an exec virtual address). Therefore, a user should reset the contents of U 
before every TRPSET call . 

A RESET UUO returns the user to normal user mode. The following instruction sequence is used to 
place the real-time device RTD on channel 3. 



INT46: BLKI RTD^ INBLOK 

INT47: JSR XITINT 



;re location constant 
;for user is added 
;to RH when instructions 
;are placed into 46 and 47. 



START: MOVE I AC*INT46 
HRLI AC*46 
TRPSET AC* 
JRST EXITR 

MOVE AC# CXWD 47, INT47] 
TRPSET AC, 
JRST EXITR 



/error return 
;normal return 

;error return 
;normal return 



XITINT: 



;PC saved 

/interrupt dismiss routine 



To maintain compatibility between a KAlO-based system and a KllO-based system, the interrupt routine 
should be executed in exec mode. However, for convenience, the routine can be executed in user 
mode in order to avoid relocation to exec virtual memory. This is possible on KAlO-based systems if 
core is taken when dismissing the internjpt (see example below). On KllO-based systems, if there is 
a possibility that the interrupt may occur during the job's background processing, the interrupt routine 
must be executed in exec mode (and thus must be locked and exec-mapped with the LOCK UUO). In 
particular, if the job is executing a UUO at background level, the use of UJEN at interrupt level may 
cause an error. On KllO-based systems it is recommended that the TRPSET interrupt routines always 
be coded to run in exec mode (refer to the RTTRP UUO for programming techniques.) 

On KAlO-based system, the interrupt routine can be coded to run in user mode if the following pro- 
cedure is observed. If the interrupt occurs while some other part of the user's program Is running, the 
user may dismiss from the interrupt routine with a JEN @ XITINT. However, if the machine is in 
exec mode, a JEN instruction issued in user mode does not work because of memory relocation. This 
is solved by a call to UJEN (op code 100). This UUO causes the monitor to dismiss the interrupt from 
exec mode. In this case, the address field of the UJEN instruction Is the user location when the 
return PC is stored (i.e., UJEN XITINT). The following sequence enables the user program to decide 
whether It can issue a JEN to save time or dismiss the interrupt with a UUO call . 
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Example (KAIO-bcrsed s/stem only): 

XI TINT: 

JRST 1*.+1 

MOVEM AC* SAVEAC 



;PC with bits in LH 

;essent-ial instruction. 
;refurre machine to 
;u$er mode. 

;save accumulator AC 
;service interrupt here 



SAVEAC : 
EFLAGs 



MOVE AC* X IT INT 
SETZM EFLAG 

TLNN AC* 1 



SETOM EFLAG 
MOVE AC* SAVEAC 
SKIPE EFLAG 
UUEN X IT INT 
JEN @ XITINT 





;get PC with bits 



;was machine in user 

;mode at entry ? 

;no 

;RESTORE saved AC 

;nOt in user mode at entry 



On entering the routine from absolute 47 with a JSR to XITINT + REL (where REL. is the relocation 
constant), the processor enters exec mode. The first executed instruction in the user's routine must, 
therefore, reset the user mode flag, thereby enabling relocation and protection. The user must pro- 
ceed with caution when changing channel interrupt chains under timesharing, making certain that the 
real-time |ob can co-exist with other timesharing jobs. 

3.8.4 UJEN (Op Code 100) 

This op code dismisses a user I/O mode interrupt if one is in progress. If the interrupt is from user 
mode, a JRST 12, instruction dismisses the interrupt. If the interrupt came from executive mode, 
however, this operator is used to dismiss the interrupt. The monitor restores all occunwlotors, and 
executes JEN @ U where user location U contains the program counter as stc^-ed by a JSR instruction 
when the interrupt occurred. 



3.8.5 HPQ AC, or CALLI AC, 71 



The HPQ UUO is used by privileged users to place their }obs in a high-priority scheduler run queue. 
These queues are always scanned by the scheduler before the normal run queues, and any runnable job 



This UUO depends on FTHPQ which is normally off in the DECsystem-1040. 
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In one of these queues is executed before all other jobs in the system. In addition, these jobs are 
given preferential access to shoroble resources (e.g., shared device controllers). Thus, real-time 
associated jobs can receive fast response from the timesharing scheduler. 

Jc^s in high-priority queues are not examined for swap-out until all other queues have been scanned. 
If a job in a high-priority queue must be swapped, the lowest priority job is transferred first, and the 
highest priority job last. If the highest priority job is swapped, then that job is the first to be swapped 
in fca" immediate execution. Therefore, in addition to being scanned before all other queues for job 
execution, the high-priority queues are examined after all other queues for swap-out and before all 
queues for swap-in. 

The HPQ UUO requires as an argument the high-priority queue number of the queue to be entered. 

The lowest high-priority queue is 1, and the highest priority queue is equivalent to the number of 

queues that the system is built for. The call is as follows: 

MOVE AC, HPQNUM ;get high-priority queue number 

HPQ AC, ;or CALLI AC, 71 

error return 
normal return 

On an error return, AC contains -1 if the user did not have the correct privileges. The privilege bits 
are 6 through 9 in the privilege word (.GTPRV). These four bits specify a number from 0-17 octal, 
which is the highest priority queue attainable by the user. 

On a normal return, the jc^ is in the desired high-priority queue. A RESET or an EXIT UUO returns 
the job to the high-priority queue specified in the last SET HPQ command. A queue number of as 
an argument places the job bac;l< to the timesharing level. 

3.9 METER.AC, OR CALLIAC, 111' 

This UUO provides a mechanism for system performance metering by allowing privileged users to 
dynamically select and collect performance statistics from the monitor. The multifunction UUO 
controls all aspects of the metering facility in order that the user can collect, present, or reduce data 
for performance analysis or can tune individual jobs or the entire system. The METER. UUO requires 
JP.MET (bit 3) to be set in the privilege word .GTPRV. 



1 
This UUO depends on FTMETR which is normally off in the DECsystem-1040. 
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The general call is; 

MOVE AC, [XWD N, ADR] 

METER. AC, ;orCALLI AC, 111 

error return 

normal return 

where 

N is the number of arguments in the argument list. 
ADR is the beginning of the argument list. 

If N is 0, the default number of arguments depends on the particular function used. Arguments in the 
list can be 1) arguments for the monitor, 2) values returned from the monitor, or 3) a combination of 
both. The first word of the argument block is the code for the particular function. The detailed 
descriptions of the various functions of the METER. UUO are presented in the METER. Specification 
in the Software Notebooks; the following is a list of the functions available. 

Description 
Initialize meter channel 
Obtain meter channel status 
Release meter channel 
Initialize meter points 
Obtain meter point status 
Release meter points 

On an errca- return, the appropriate error code is returned in AC. Refer to the METER. Specification 
for the error codes. 

On a normal return, AC is perserved. 



Function Code 


Name 





.MEFCI 


1 


.ME PCS 


2 


.MEFCR 


3 


.MEFPI 


4 


.MEFPS 


5 


.MEFPR 
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CHAPTER 4 

I/O PROGRAMMING 



All user-mode l/O programming is controlled by monitor programmed operators. I/O is directed by 

a. Associating a device and a ring of buffers with one of the user's I/O channels (INIT, 
OPEN). 

b. Optionally selecting a file (LOOKUP, ENTER). 

c. Passing buffers of data to or from the user program (IN , INPUT, OUT, OUTPUT). 

Device specification may be delayed from program -generation time until program-run time because 
the monitor 

a. Allows a logical device name to be associated with a physical device (ASSIGN or MOUNT 
monitor command). 

b. Treats operations that are not pertinent to a given device as no-operation code. 

For example: a rewind directed to a line printer does nothing, and file selection operations for de- 
vices without a filename directory are always successful. 

4.1 I/O ORGANIZATION 
4.1.1 Files 

A file is an ordered set of data on a peripheral device. The extent of a file on input is determined by 
an end-of-file condition dependent on the device. For example: a file is terminated by reading an 
end-of-file gap from magnetic tape, by an end-of-file card from a card reader, or by depressing the 
end-of-file switch on a card reader (refer to Chapter 5). The extent of a file on output is determined 
by the amount of information written by the OUT or OUTPUT programmed operators up through and 
including the next CLOSE or RELEAS operator. 

4.1.2 Job I/O Initialization 
The monitor programmed operator 

CALL CSIXBIT /RESET/] or CALLI 
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should normally be fhe first insf-ruction in each user program. It immediately stops all I/O transmis- 
sions on all devices without waiting for the devices to become inactive. All device allocations made 
by the I NIT and OPEN operators are cleared and, unless the devices have been assigned by the 
ASSIGN or MOUNT monitor command, the devices are returned to the monitor facilities pool. The 
content of the left half of . JBSA (program break) is stored in the right half of . JBFF so that the user 
buffer area is reclaimed if the program restarts. The left half of .JBFF is cleared. Any files that 
have not been closed are deleted on disk. Any older version with the same filename remains. The 
user-mode write -protect bit is automatically set if a high segment exists, whether it is sharable or not; 
therefore, a program cannot inadvertently store into the high segment. Additional functions of the 
RESET DUO include 1) unlocking the job if it was locked, 2) releasing any real-time devices, 3) re- 
setting any high-priority queues set by the HPQ UUO to the value set by the HPQ command, 4) re- 
suming timesharing if it was stopped as a result of a TRPSET UUO with a non-zero argument, 5) reset- 
ting the action of the HIBER and APRENB UUOs, and 6) clearing all PC flags except USRMOD. 

4.2 DEVICE SELECTION 

For all I/O operations, a specific device must be associated with a software I/O channel. This speci- 
fication is made by an argument of the INIT or the OPEN programmed operators. The INIT or the 
OPEN programmed operators may specify a device with a logical name that is associated with a par- 
ticular physical device by the ASSIGN or MOUNT monitor command. Some system programs, e.g., 
LOGOUT, require I/O to specific physical devices regardless of what logical names have been as- 
signed. Therefore, on an OPEN UUO, if the sign bit of word of the OPEN block is 1 (UU. PHS), 
the device name is taken as a physical name only, and logical names are not searched. A given de- 
vice remains associated with a software I/O channel until released (refer to Paragraph 4.8.1) or until 
another INIT or OPEN is performed for that channel. Devices are separated into two categories: 
those with no filename directory (refer to Chapter 5) and those with at least one filename directory 
(refer to Chapter 6). 

Assignable devices (i.e., non-disk and non-spooled devices) in the monitor's pool of available 
resources are designated as being either unrestricted or restricted. An unrestricted device can be 
assigned directly by any job via the ASSIGN command or INIT or OPEN UUO. A restricted device 



can be assigned directly only by a privileged job (i.e., a job logged in under [1,2] or running with 
the JACCT bit set). However, anon-privileged user can have a restricted device assigned to him indi- 
rectly via the MOUNT command. This command allows operator intervention for the selection or 
denial of a particular device; thus the operator can control the use of assignable devices for the non- 
privileged user. This is particularly useful when there are multiprogramming batch and interactive jobs 
competing for the same devices. The restricted status of o device is set or removed by the operator with 
the OPSER commands cRESTRICT and rUNRESTRICT, which use the privileged UUOs, DVRST. and 
DVURS. (refer to UUOPRV in the DECsystem-10 Software Notebooks). 

4.2.1 Nondirectory Devices 

For nondirectory devices (e.g., card reader and punch, line printer, paper-tape reader and punch, 
and user terminal), selection of the device is sufficient to allow I/O operations over the associated 
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software channel. All other file specifiers, if given, are ignored. Magnetic tape, a nondirectory 
device, requires, in addition to the name, that the tape be properly positioned. It is advisable to 
use the programmed operators that select a file, so that a directory device may be substituted for a 
nondirectory device at run time. 

4.2.2 Directory Device 

R>r directory devices (e.g., DECtape and disk), files are addressable by name. If the device has a 
single file directory (e.g., DECtape) the device name and filename are sufficient information to de- 
termine a file. If the device has multiple file directories (e.g., disk) the name of the file directory 
must also be specified. These names are specified as arguments to the LOOKUP, ENTER, and RENAME 
programmed operators. 

4.2.3 Device Initialization 

The OPEN (operation code 050) and INIT (operation code 041) programmed operators initialize a de- 
vice and associate it with a software I/O channel number for the job. These UUOs perform almost 
Identical functions; the OPEN UUO is a reentrant form of INIT and Is preferred for this reason. In 
addition to the device name, these programmed operators accept, as arguments, an initial file status 
and the location of the input and output buffer headers. The calls are: 

OPEN D, SPEC INilTD, STATUS 

error return SIX BIT /dev/ 

normal return XWD OBUF, IBUF 

error return 

'' normal return 

SPEC: EXP STATUS 

SIXBIT/dev/ 

XWD OBUF, IBUF 

The normal return is taken If a device is selected, and if the device is associated with a software I/O 
channel. The error return Is taken if the requested device is in use, if the requested device does not 
exist, or If the device is restricted and has not been assigned with the MOUNT command. 



4.2.3.1 Data Channel - These programmed operators establish a correspondence between the device 
and a 4-bit channel number, D. Most of the other input/output operators require this channel number 
as an argument. If a device is already assigned to channel D, it is released (refer to Paragraph 4.8.1), 

4.2.3.2 Device Name - The device name, dev, is either a logical or physical device name, with 
logical names taking precedence over physical names. With multiple stations, the method of device 
selection depends on the format of the specified SIXBIT device name. 

If devn (e.g., LPT7, CDR3) is specified, the monitor attempts to select the device specifically re- 
quested . 
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If devSnn (e.g., CDPS14, PTPS12) is specified, the monitor attempts to select any device of the de- 
sired type at the requested station. If a device of the desired type has been previously assigned to 
this job at the requested station and is not INITed on another channel, it will be selected in prefer- 
ence to an unassigned device. 

If dev (e.g., LPT, DTA) is specified, the monitor attempts to select a device of the desired type at 
the job's logical station. If all devices of this type are in use, the error return is taken. If no device 
of the desired type exists at the user's logical station, the monitor attempts to select the device at the 
central station. If the desired type of device has already been assigned to the job at the appropriate 
station (either the job's logical station or the central station) and is not INITed on another channel, it 
will be selected instead of an unassigned device. 

In non-disk systems, if the specified device is the system device SYS, the job is ploced into a system 
device wait queue and continues to run when SYS becomes available. In disk systems where the sys- 
tem device is one or more file structures, control returns immediately. 

The job may pause with the message 

7STATION nn NOT IN CONTACT 

if the requested station is not in contact with the central station. After station nn has established 
contact with the central station, the user types CONTINUE for a return to job execution. 

4.2.3.3 Initial File Status - The file status, including the data mode, is set to the value of the sym- 
bol STATUS. Thereafter, bits are set by the monitor and may be tested and reset by the user via 
monitor programmed operators. Bits 30-35 of the file status are normally set by an OPEN or INIT 
UUO. Refer to Table 4-3 in Paragraph 4.6.2 for the file status bits. If the data mode is not legal 
(refer to Chapters 5 and 6) for the specified device, the job is stopped and the monitor prints 

ILL DEVICE DATA MODE FOR DEVICE dev AT USER addr, 

where dev is the physical name of the device and addr is the location of the OPEN or INIT operator 
on the user's terminal. The terminal is left in monitor mode. 

4.2.3.4 Data Modes - Data transmissions are either unbuffered or buffered. (Unbuffered mode is 
sometimes referred to as dump mode.) The mode of transmission is specified by a 4-bit argument to the 
INIT, OPEN, or SETSTS programmed operator. Tables 4-1 and 4-2 summarize the data modes. 
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Table 4-1 
Buffered Data NAodes 



Octal Code 




1 

2-7 

n-12 
13 

14 



Name 



.lOASC 
.lOASL 

.lOIMG 

.lOIBN 
.lOBIN 



Meaning 



ASCII. Seven bit bytes packed left justified, five characters 
per word . 

ASCII line. Same as 0, except that the buffer is terminated 
by a FORM, VT, LINE- FEED, or ALTMODE character. Dif- 
fers from ASCII on TTY (half-duplex software) and PTR only. 

Unused. 

Image. A device dependent mode. Thirty-six bit bytes. 
The buffer is filled with data exactly as supplied by the de- 
vice. 
Unused . 

Image binary. Thirty-six bit bytes. This mode is similar to 
binary mode, except that no automatic formatting or check- 
summing is done by the monitor. 

Binary. Thirty-six bit bytes. This is blocked format con- 
sisting of a word count, n (the right half of the first data 
word of the buffer), followed by n 36-bit data words. 
Checksum for cards and paper tape. 



Octal Code 



15 
16 

17 



Name 



.lOIDP 
.lODPR 

.lODMP 



Table 4-2 
Unbuffered Data Modes 



Meaning 



Image dump. A device dependent dump mode. Thirty-six 
bit bytes. 

Dump as records without core buffering. Data is transmitted 
between any contiguous blocks of core and one or more stan- 
dard length records on the device for each command word in 
the command list. Thirty-six bit bytes. 

Dump one record without core buffering. Data is transmitted 
between any contiguous block of core and exactly one rec- 
ord of arbitrary length on the device for each command word 
in the command list. Thirty-six bit bytes. 



4.2.3.5 Buffer Header - Symbols OBUF and IBUF, if non-zero specify the location of the first word 
of the 3-word buffer ring header block for output and input, respectively. Buffered data modes utilize 
a ring of buffers in the user area and the priority interrupt system to permit the user to overlap compu- 
tation with his data transmission. Core memory in the user's area serves as an intermediate buffer 
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between fhe user's program and fhe device. The buffer storage mechanism consists of a 3-word buffer 
ring header block for bookkeeping and a data storage area subdivided Into one or more Individual buf- 
fers linked together to form a ring. During input operations, the monitor fills a buffer, makes that 
buffer available to the user's program, advances to the next buffer In the ring, and fills that buffer If 
it is free. The user's program Follows the monitor, either emptying the next buffer If it is full or wait- 
ing for it to fill. 

During output operations, the user's program and the monitor exchange roles; the user program fills the 
buffers and the monitor empties them. Only the headers that will be used need to be specified, for 
instance, the output header need not be specified. If only Input is to be done. Also, data modes 15, 
16, and 17 require no header. If either of the buffer headers or the 3-word block starting at location 
SPEC lies outside the user's allocated core areat, the job Is stopped and the monitor prints 
ILLEGAL UUO AT USER addr 

(addr is the address of the OPEN or INIT operator) on the user's terminal, leaving the terminal In mon- 
Itor mode. 

The first and third words of the buffer header are set to zero. The left half of the second word Is set 
up with the byte pointer size field In bits 6 through 1 1 for the selected device-data mode combination. 

If the same device (other than disk) is INITed on two or more channels, the monitor retains only the 
buffer headers mentioned in the last INIT (a specification does not oven-Ide a previous buffer header 
specification). Other l/O operations to any of the channels Involved act on the bi;ffers mentioned In 
the last INIT previous to the I/O operations. 

4.3 RING BUFFERS 

4.3.1 Buffer Structure 

The ring buffer (see Figure 4-1) is comprised of a buffer ring header block and buffer rings. 

4.3. 1 . 1 Buffer Ring Header Bl<x:k - The location of the 3-word buffer ring header block Is specified 
by an argument of the INIT and OPEN operators. Information is stored in the header by the monitor 
in response to the user execution of monitor programmed operators. The user's program finds all the 
information required to fill and empty buffers In the header. Bit position of the first word of the 
header Is a flag, which, if 1 , means that no Input or output has occun-ed for this ring of buffens. The 



^ ^ mP^^^°f T7u°\^^ '" n^ user's AQ; however, the buffer headers may be in location above 
• JBRH (refer to Table 1-1 in Paragraph 1.2.1). 
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right half of the first word is the address of the second word of the buffer currently used by the user's 
program. The second word of the header contains a byte pointer to the current byte in the current 
buffer. The byte size is determined by the data mode. The third word of the header contains a number 
of bytes remaining in the buffer. A program may not use a single buffer header for both input and out- 
put, nor may a single buffer ring header be used for more than one I/O function at a time. Users can- 
not use the same buffer ring for simultaneous input and output; only one buffer ring is associated with 
each buffer ring header. 



BUFFER RING 



USE BIT 



BUF 1: 



FILE STATUS 



SIZE 



BOOKKEEPING 
WORD 



BUF 2 



WORD COUNT 



DATA 



BUFFER RING 
HEADER BLOCK 







USE BIT s^ 


FILE STATUS 


USE 
BIT 


CURRENT 
BUFFER 




SIZE 


BUF 3 


BUF 2! 


BUFFER POINTER 


BOOKKEEPING 
WORD 


WORD COUNT 


BYTE COUNTER 












DA 


TA 



USE BIT 



BUF 3: 



FILE STATUS 



SIZE 



BOOKKEEPING 
WORD 



BUF 1 



WORD COUNT 



DATA 



Figure 4-1 User's Ring of Buffers 

4.3.1 .2 Buffer Ring - The buffer ring is established by the INBUF and OUTBUF operators, or, if 
none exists when the first IN, INPUT, OUT, or OUTPUT operator is executed, a 2-buffer ring is set 
up. The effective address of the INBUF and OUTBUF operators specifies the number of buffers in the 
ring. The location of the buffer ring is specified by the contents of the right half of .JBFF in the 
user's job data area. The monitor updates .JBFF to point to the first location past the storage area. 
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All buffers in the ring are identical in structure. The right half of the first word contains the file sta- 
tus when the monitor advances to the next buffer in the ring (see Rgure 4-2). Bit of the second 
word of a buffer, the use bit, is a flag that indicates whether the buffer contains active data. This 
bit is set to 1 by the monitor when the buffer is full on input or being emptied on output, and set to 
when the buffer is empty on output or is being filled on input. In other words, if the use bit = 0, the 
buffer is available to the filler; if the use bit = 1 , the buffer is available to the emptier. The use bit 
prevents the monitor and the user's program from interfering with each other by attempting to use the 
same buffer simultaneously. Buffers are advanced by the UUOs and not by the user's program. The 
use bit in each buffer should never be changed by the user's program except by means of the UUOs. 
Bits 1 through 17 of the second word of the buffer contain the size of the data area of the buffer plus 
1 . The size of this data area depends on the device. The right half of the third word of the buffer is 
reserved for a count of the number of words that actually contain data. TTie left half of this word is 
reserved for other bookkeeping purposes, depending on the particular device and the data mode. 



USE 
BIT 





FILE STATUS 


-»> 


SIZE OF 
DATA AREA 


ADDRESS OF SECOND 
WORD OF NEXT BUFF- 
ER IN RING 


BOOKKEEPING 


WORDS COUNT, N 


N DATA WORDS 


UNUSED 



FIRST WORD 
SECOND WORD 
THIRD WORD 

DATA AREA 



Figure 4-2 Detailed Diagram of Individual Buffer 

4.3.2 Buffer Initialization 

Buffer data storage areas may be established by the INBUF and OUTBUF programmed operators, or by 
the first IN, INPUT, OUT, or OUTPUT operator, if none exists at that time, or the user may set up 
his own buffer data storage area., 

4.3.2.1 Monitor Generated Buffers - Each device has an associated standard buffer size (refer to 
Chapters 5 and 6). The monitor programmed operators INBUF D,n (operation code 064) and 
OUTBUF D,n (operation code 065) set up a ring of n standard size buffers associated with the input 
and output buffer headers, respectively, specified by the last OPEN or INIT operator on data channel 
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D. If n = on either INBUF or OUTBUF, the default number of buffers for the specified device is set 
up. If no OPEN or I NIT operator has been performed on channel D, the monitor stops the job and 
prints 

I/O TO UNASSIGNED CHANNEL AT USER addr 

(addr is the location of the INBUF or OUTBUF operator) on the user's terminal leaving the terminal in 
the monitor mode. 

The storage space for the ring is taken from successive locations, beginning with the location speci- 
fied in the right half of .JBFF. This location is set to the program break, which is the first free loca- 
tion above the program area, by RESET. If there is insufficient space to set up the ring, the monitor 
automatically attempts to expand the user's core allocation by IK. If this fails, the monitor stops the 
job and prints 

ADDRESS CHECK FOR DEVICE dev AT USER addr 

(dev is the physical name of the device associated with channel D and addr is the location of the 
INBUF or OUTBUF operator) on the user's terminal, leaving the terminal in monitor mode. 

This message is also printed when an INBUF (OUTBUF) is attempted if the last INIT or OPEN UUO 
on channel D did not specify an input (output) buffer header. 

The ring is set up by setting the second word of each buffer with a zero use bit, the appropriate data 
area size, and the link to the next buffer. The first word of the buffer header is set with a 1 in the 
ring use bit, and the right half contains the address of the second word of the first buffer. 

4.3.2.2 User Generated Buffers - The following code illustrates an alternative to the use of the 
INBUF programmed operator. Analogous code may replace OUTBUF. This user code operates similar- 
ly to INBUF. SIZE must be set equal to the greatest number of data words expected in one physical 
record. 
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OPEN I,OPNBLK ;INITIALIZE ASCII MODE 

JRST NOTAVL ;THE 400000 IN THE LEFT HALF 

;MEANS THE BUFFER WAS NEVER 
MOVE 0* CXWD 400000*BUFl+i ] -REFERENCED. 

;SET UP NON-STANDARD BYTE 
MOVEM &* MAGBUF ;SIZE 



MOVE 0* CPOINT BYTSIZ*0*35] 

MOVEM 0# MA 
JRST CONTIN 



;MAGNEnC TAPE UNIT 

MOVEM 0* MA6BUF + 1 ;INPUT ONLY 



5.04 Monitor 
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OPNBLK: 

SIXBIT/MTA0/ 
XWD 0*MAGBUF 

MAGBUF: BLOCK 3 

BUF 1 I 

XWD SIZE+1 >BUF2+1 



BLOCK SIZE +1 



BUF2 ; 

XWD SIZE + 1 *BUF3-fl 
BLOCK SIZE+1 

BUF3; 

XWD SIZE+1 ,BUF1+1 
BLOCK SIZE+1 



GO BACK TO MAIN SEQUENCE 
SPACE FOR BUFFER RING HEADER 
BUFFER 1, 1ST WORD UNUSED 
LEFT HALF CONTAINS DATA AREA 
SIZE+1 , RIGHT HALF HAS 
ADDRESS OF NEXT BUFFER 
SPACE FOR DATA, 1ST WORD 
RECEIVES WORD-COUNT. THUS 
ONE MORE WORD IS RESERVED 
THAN IS REQUIRED FOR DATA 
ALONE 
SECOND BUFFER 

;THIRD BUFFER 

;RIGHT HALF CLOSES THE RING 



4.4 FILE SELECTION (LOOKUP and ENTER) 

The LOOKUP (operation code 076) and ENTER (operation code 077) programmed operators select a 
file for input and output, respectively. These operators are not necessary for nondirectory devices; 
however, it is good programming practice to always use them so that directory devices may be substi- 
tuted at run time (refer to ASSIGN command). The monitor gives the normal return for a LOOKUP 
or ENTER to a nondirectory device; therefore, user programs can be coded in a device-independent 
fashion. 

4.4.1 The LOOKUP Operator 

LOOKUP selects a file for inpKjt on channel D. 

LOOKUP D,E 
error return 
normal return 



E: SIXBIT/file/ ;filename, 1 to 6 characters, left-justified 

SIXBIT/ext/ ;filename extension, to 3 

;characters, left-justified 
;The remaining words in the argument block 
— ;are ignored for nondirectory devices. Refer 

;to Paragraph 6.1.5.1 for the DECtape 
; LOOKUP and Paragraph 6.8.2.1 for the 
;disl< LOOKUP. 

If no device has been associated with channel D by an INIT or OPEN UUO, the monitor stops the job, 
prints 

I/O TO UNASSIGNED CHANNEL AT USER LOC addr 
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-i|71- nONITOR CALLS 

and returns the user's terminal to monitor mode. The input side of channel D is closed if not already 
closed. The output side is not affected. 

On DECtape, LOOKUP searches the device directory as specified by an INIT. On disk, the user's 
file directory as specified by the contents of location E+3 is searched . Refer to Paragraph 6. 1 .5. 1 
for details of a DECtape LOOKUP and Paragraph 6.8.2.1 for details of a disk LOOKUP. 

If the device is a directory device and the file is found, the normal return is taken and information 
concerning the file is returned in location E+1 through E+3. The normal return is always taken if the 
device associated with the channel D does not have q directory. The error return is taken if 1) the 
file is not found, 2) the file is found but the user does not have access to it (refer to Paragraph 6.2.3 
for the description of file access codes), or 3) the device associated with channel D is a non-input 
device. Refer to Appendix E for the en-or codes returned in bits 18-35 of location E+1 . 

4.4.2 The ENTER Operator 

ENTER selects a file for output on channel D. 

ENTER D, E 
error return 
normal return 

E: SIXBIT/file/ /filename, 1 through 6 

/characters, left-justified 
SIXBIT/ext/ /filename extension, through 3 characters, 

; I eft- just if led 

;The remaining words in the argument block are 

/ignored for nondirectory devices. Refer to 

/Paragraph 6.1.5.2 for the DECtape ENTER 
/and Paragraph 6.8.2.1 for the disk ENTER. 

If no device has been associated with channel D by an INIT or OPEN UUO, the monitor stops the 
job, prints 

I/O TO UNASSIGNED CHANNEL AT USER LOC addr 

and returns the user's terminal to monitor mode. The output side of channel D is now closed (if it was 
not closed); the input side is not affected. On DECtape, ENTER searches the device directory as 
specified by an INIT. On disk, the user's file directory, as specified by the contents of location 
E+3, is searched. 

If the device does not have a directory, the normal return is always taken. On directory devices, if 
the file is found and is not being written or renamed, the file is deleted (the user must hove access 
privileges to the file), and the storage space on the device is reclaimed. On DECtape, this deletion 
must occur immediately on ENTE^R to ensure that space is available for writing the new version of the 
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file. On disk, the deletion of the previous version does not occur until output CLOSE time, provided 
bit 30 of CLOSE is (refer to Paragraph 4.7.7). Consequently, if the new file is aborted when par- 
tially written, the old version remains. The normal return is taken, and the monitor makes the file 
entry, and records file information. 

The error return is taken if: 

a. The filename in location E is 0. 

b. The file is found but is being written or renamed. 

c. The user does not have access to the file, as supplied by the file if it exists or 
by the UFD if the file does not exist. 

d. The device associated with channel D is a non-output device. 

Refer to Paragraph 6.8.2. 1 for details of a disk ENTER and Paragraph 6.1.5.2 for details of a DEC- 
tape ENTER. Refer to Appendix E for the error codes returned in bits 18-35 of location E+1. 

4.4.3 RENAME Operator 

The RENAME (operation code 055) programmed operator is used 

a. To alter the filename, filename extension, and file access privileges 

b. To delete a file associated with channel D on a directory device 

RENAME D,E 
error return 
normal return 



E: SIXBIT/flle/ 
SIXBIT/ext/ 



filename, 1 to 6 characters 
filename extension, to 3 
characters. 

The remaining words in the 
argument block are ignored 
for nondirectory devices. 
Refer to Paragraph 6. 1 .5.3 
for the DECtape RENAME 
and Paragraph 6.8.2. 1 for 
the disk RENAME. 

If no device has been associated with channel D, the monitor stops the job, prints 

I/O TO UNASSIGNED CHANNEL AT USER LOC addr 
and returns the user's terminal to monitor mode. 
The normal return is given if: 

a. The device specified Is a nondirectory device. 

b. If the filename specified in location E is 0, the file is deleted after all 
read references are completed. 

c. If the filename specified In location E and the filename extension specified In 
the left half of location E+1 are the same as the current filename and filename 
extension, the access protection bits are set to the contents of bits to 8 of 
location E+2. 
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d. If the filename/filename extension specified differ from the current filename/filename 
extension, a search is made for the specified filename and filename extension. If a 
match is not found (1) the filename is changed to the filename in location E, (2) the 
filename extension is changed to th6 filename extension in the left half of location 
E+1, (3) the access protection bits are changed to the contents of bits 0-8 of location 
E+2, and (4) the access date is unchanged. 

The error return is given if: 

a. No file is selected on channel D. 

b. The specified file is not found. 

c. The file is found but is being written, superseded, or renamed. 

d. The file is found but the user does not have the privileges to RENAME the file. 

e. The filename/filename extension specified differ from the current filename/filename 
extension, a search is made for the specified filename and filename extension. If a 
match is found, the error return is taken. 

f. The UFD is deleted. 



Refer to Appendix E for the error codes returned in bits 18-35 of location E+1 . Refer to Paragraph 
6.1 .5.3 for details of a DECtape RENAME and Paragraph 6.8.2.1 for details of a disk RENAME. 



Examples 



General Device Initialization 



INIDEVS 

OPEN 3*0PNBLK 
JRST NOTAVL 



JSR HERE 

CHANNEL 3 

WHERE TO GO IF DTA5 IS BUSY 



;FROM HERE DOWN IS OPTIONAL DEPENDING ON THE DEVICE AND PROGRAM 
;REQUIREMENTS 



MOVE 0> JOBFF 
MOVEM 0* SVJBFF 



INBUF 3*4 
OUTBUF 3*1 
LOOKUP 3* INNAM 
JRST NOTFND 

ENTER 3* OUTNAME 
JRST NOROOM 





JRST §INIDEV 


OPNBLK.S 


14 




SIXBIT/DTA5/ 




XWD OBUF* IBUF 


OBUF: 


BLOCK 3 


IBUF: 


BLOCK 3 



SAVE THE FIRST ADDRESS OF THE BUFFER 

RING IN CASE THE SPACE MUST BE 

RECLAIMED 

SET UP 4 INPUT BUFFERS 

SET UP 1 OUTPUT BUFFER 

INITIALIZE AN INPUT FILE 

WHERE TO GO IF THE INPUT FILENAME IS 

NOT IN THE DIRECTORY 

INITIALIZE AN OUTPUT FILE 

WHERE TO GO IF THERE IS NO ROOM IN 

THE DIRECTORY FOR A NEW FILENAME 

RETURN TO MAIN SEQUENCE 

BINARY MODE 

DEVICE DECTAPE UNIT 5 

BOTH INPUT AND OUTPUT 

SPACE FOR OUTPUT BUFFER HEADER 

SPACE FOR INPUT BUFFER HEADER 

(continued on next page) 
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innam: sixbit/name/ 
sixbit/ext/ 







outnam: s I xb it/name/ 

SIXBIT/EXT/ 






FILE NAME 

FILE NAME EXTENSION (OPTIONALLY 0), 

RIGHT HALF WORD RECEIVES THE 

FIRST BLOCK NUMBER 

RECEIVES THE DATE 

UNUSED FOR N ON DUMP I/O 

SAME INFORMATION AS IN INNAM 



4.5 DATA TRANSMISSION 

The programmed operators 

INPUT D,Eand IN D,E 

normal return 
error return 

transmit data from the file selected on channel D to the user's core area. The programmed operators 

OUTPUT D,EandOUT D,E 

normal return 
error return 

transmit data from the user's core area to the file selected on channel D. If specified, E is the 
effective address of the next buffer to be written. If E is not specified, the next buffer in the 
sequence is implied. 

If no OPEN or I NIT operator has been performed on channel D, the monitor stops the job and prints 

I/O TO UNASSIGNED CHANNEL AT USER addr 

(addr is the location of the IN, INPUT, OUT, or OUTPUT programmed operator) on the user's terminal 
and the terminal is left in monitor mode. If the device is a multiple-directory device and no file is se- 
lected on channel D, bit 18 of the file status is set to 1 , and control returns to the user's program. 
Control always returns to the location immediately following an INPUT (operation code 066) and an 
OUTPUT (operation code 067). A check of the file status for end-of-file and error conditions must 
then be made by another programmed operator. Note that to trap on a hardware write-locked device, 
the user should use location .JBINT (refer to Paragraph 3.1 .3.2). Following an INPUT, the user pro- 
gram should check the word count of the next buffer to determine if it contains data. Control returns to 
the location immediately following an IN (operation code 056) if no end-of-file or error condition ex- 
ists (i.e., if bits 18 through 22 of the file status are all 0). Control returns to the location immediate- 
ly Following an OUT (operation code 057) if no error condition or end-of-tape exists (i.e., if bits 18 
through 21 and bit 25 are all zero). Otherwise, control returns to the second location following the 
IN or OUT. Note that IN and OUT UUOs are the only ones in which the error return is a skip and the 
normal return is not a skip. 
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4.5.1 Unbuffered Data Modes 

Data modes 15, 16, and 17 utilize a command list to specify areas in the user's allocated core to be 
read or written. The effective address E of the IN, INPUT, OUT, and OUTPUT programmed operators 
point to the first word of the command list. Three types of entries may occur in the command list. 

a. lOWD n, loc - Giuses n words from loc through loc+n-1 to be transmitted. The next 
command is obtained from the next location following the lOWD. The assembler pseudo- 
op lOWD generates XWD -n, loc-1 . 

b. XWD 0, y - Causes the next command to be taken from location y . Referred to as a 
GOTO word. Up to three consecutive GOTO words are allowed in the command list. 
After three consecutive GOTO words, an I/O instruction must be written. 

c. - Terminates the command list. 

Each lOWD which causes data to be transferred writes a separate record. Thus, for devices other than 
DECtape, the following two examples produce the same result. 

1) OUTPUT D, [lOWD 100, BUFl 

lOWD 100, BUF2 
Z3 

2) OUTPUT D, [lOWD 100, BUFl 

Z] 

OUTPUT D, CIOWD 100, BUF2 
Z] 

For DECtape (where space is an important consideration), the first example writes one block, and the 
second writes two. 

The monitor does not return program control to the user until the command list has been completely 
processed. If an illegal address is encountered while processing the list, the job is stopped and the 
monitor prints 

ADDRESS CHECK AT USER addr 

on the user's terminal and the terminal is left in monitor mode. 

Example: Dump Output 

Dump input is similar to dump output. This routine outputs fixed-length records. 



DMPINI: 

OPEN 0*0PNBLK 

JRST NOTAVL 

JRST @ DMPINI 



DMPOUT: 



OUTPUT 0*OUTLST 

STATZ 0* 740000 

CALLCSIXBIT /EXIT/3 
JRST iDMPOUT 



JSR HERE TO INITIALIZE A FILE 

CHANNEL 

WHERE TO GO IF MTA2 IS BUSY 

RETURN 

JSR HERE TO OUTPUT THE OUTPUT AREA 

SPECIFIES DUMP OUTPUT ACCORDING 

TO THE LIST AT OUTLIST 

CHECK ERROR BITS 

QUIT IF AN ERROR OCCURS 

RETURN 
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OPNBLK: 



OUTLST 



CLOSE 0* 

STATZ 0* 740000 

CALLCSIXBIT /EXIT/3 
RELEAS 0* 
JRST QDMPDON 
16 

SI KBIT /MTA2/ 

lOWD BUFSIZ, BUFFER 



BUFFER; BLOCK BUFSIZ 



JSR HERE TO WRITE AN END OF FILE 

WRITE THE END OF FILE 

CHECK FOR ERROR DURING WRITE 

END OF FILE OPERATION 

QUIT IF ERROR OCCURS 

RELINQUISH THE DEVICE 

RETURN 

DUMP MODE 

MAGNETIC TAPE UNIT 2 

NO RING BUFFERS 

SPECIFIES DUMPING A NUMBER OF 

WORDS EQUAL TO BUFSIZ, STARTING 

AT LOCATION BUFFER 

SPECIFIES THE END OF THE COMMAND 

LIST 

OUTPUT BUFFER, MUST BE CLEARED 

AND FILLED BY THE MAIN PROGRAM 



4. ,5. 2 Buffered Data Modes 

In data modes 0, \, 10, 13, and 14 the effective address E of the INPUT, IN, OUTPUT and OUT 
programmed operators may be used to alter the normal sequence of buffer reference. If E is 0, the 
address of the next buffer is obtained from the right half of the second word of the current buffer. 
If E is non-zero, it is the address of the second word of the next buffer to be referenced. The buffer 
pointed ta by E can be in an entirely separate ring from the present buffer. Once a new buffer loca- 
tion is estcfclished, the following buffers are taken from the ring started at E. Since buffer rings ere 
not changed if I/O activity is pending, it is not necessary to issue a WAIT UUO. 

4.5.2. 1 Input - If no input buffer ring is established when the first INPUT or IN is executed, a 
2-buffer ring is set up (refer to Paragraph 4.3.2). 

Buffered input may be performed synchronously or asynchronously at the option of the user. If bit 30 
of the file status is 1, each INPUT and IN programmed operator performs the following: 

(1) Clears the use bit in the second word of the buffer with an address in the right half 
of the first word of the buffer header, thereby making the buffer available for re- 
filling by the monitor. 

(2) Advances to the next buffer by moving the contents of the second word of the current 
buffer to the right half of the first word of the 3-word buffer header. 

(3) Returns control to the user's program if an end-of-file or error condition exists. 
Otherwise, the monitor starts the device, which fills the buffer and stops transmission, 

(4) Computes the number of bytes in the buffer from the number of words in the buffer 
(right half of the first data word of the buffer) and the byte size, and stores the re- 
sult in the third word of the buffer header. 

(5) Sets the position and address fields of the byte pointer in the second word of the 
buffer header, so that the first data byte is obtained by an ILDB instruction. 

(6) Returns control to the user's program. 

Thus, in synchronous mode, the position of a device (e.g., magnetic tape), relative to the current 
data, is easily determined. The asynchronous input mode differs in that once a device is started, suc- 
cessive buffers in the ring are filled at the internjpt level without stopping transmission until a buffer 
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whose bit Is 1 is encounfered. Control returns to the user's program after the first buffer is filled. The 
position of the device, relative to the data currently being processed by the user's program, depends 
on the number of buffers in the ring and when the device was last stopped. 
Example: General Subroutine to Input One Character 

jGET -- ROUTINE TO GET ONE BYTt FROM THE INPUT FILE 

I NULLS (0) WILL Bt OiyCAROED 

JCALL: JSP A, GET 

> END-OF-FILE RElUr^N 

; RETURN WITH BYTE IN ? 



GET! 



SOSGE 


IB + 2 


JRST 


GET8F 


ILDB 


c»ia+i 


JUMPN 


C,1(A) 



JRST 



GET 



IDECREMENT THE BYTE COUNT 

IBUFFER EMPTY--GET ANOTHEH ONE 

{SOMETHING THERE--GET IT 

IRETURN IF NOT NULL 

M* IF NULLS ARE SIGNIFICANTi THIS 

> SHOULD BE A JRST 1U> 

JNULL--LO0P FOR ANOTHER CHARACTER 



;HERE WHEN INPUT BUFFER IS EMPIY 

;ASK the MONITOR FOR THE NEXT BUFFER AND JUMP BACK 

JRETURN TO USER IF END-QF-FUE 



getbf; 



I.N 

JRST 
GETSTS 
TRNN 
JRST 



TRZ 
SETSTS 



getbfes 



TRNE 
JRST 
JRST 



I, IGET BUFFER FROM MONITOR 

GET JNO ERRORS OR EOF-'JUMP BACK 

1,C IGET ERROR STATUS 

C,74B?.3 ISEE IF ANY ERRORS 

GETBFE INO--GO CHECK EOF 

|*» INSERT ERROR ROUTINE HERE 

J FOH EXAMPLE, TYPE C IN OCJAU 

1 WITH MESSAGE GIVING FILE NAMEi ETC, 

C,74B23 ICLEAR ERROR BITS 

I,(C) ITELL MONITOR 

C,1R22 ISEE IF END OF FJLE 

^A) IYES--GIVE NON-SKIP RETURN 

GET INO--JUMP BACK TO PROCESS DATA 



4.5.2.2 Output - If no output buffer ring has been established (i.e. , if the first word of the buffer 
header is 0), when the first OUT or OUTPUT is executed, a 2-buffer ring is set up (refer to Paragraph 
4.3.2). If the ring use bit (bit of the first word of the buffer header) is 1 , it is set to 0, the cun-ent 
buffer is cleared to all Os, and the position and address fields of the buffer byte pointer (the second 
word of the buffer header) are set so that the first byte is properly stored by an IDPB instruction. The 
byte count (the third word of the buffer header) is set to the maximum of bytes that may be stored in 
the buffer, and control is returned to the user's program. Thus, the first OUT or OUTPUT initializes 
the buffer header and the first buffer, but does not result in data transmission. 

If the ring use bit is and the bit 31 of the file status is 0, the number of words in the buffer is com- 
puted from the address field of the buffer byte pointer (the second word of the buffer header) and the 
buffer pointer (the first word of the buffer header), and the result is stored in the right half of the third 
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word of the buffer. If bif 31 of the file status is 1 , it is assumed that the user has already set the word 
count in the right half of the third word. The buffer use bit (bit of the second word of the buffer) is 
set to 1, indicating that the buffer contains data to be transmitted to the device. If the device is not 
currently active (i.e. , not receiving data), it is slarted. The buffer header is advanced to the next 
buffer by setting the buffer pointer in the first word of the buffer header. If the buffer use bit of the 
new buffer is }, the |ob is put into a wait state until the buffer is emptied at the interrupt level. The 
buffer is then cleared to Os, the buffer byte pointer and byte count are initialized in the buffer header, 
and control is returned to the user's program. 

Example: General Subroutine to Output One Character 

;PIJT -- ROUTIME TO PUT ONE 8YTL iNjTQ THE OUTPUT FILE 

ICALL5 MOVE CtJYTE - - 

; JSP A, PUT 

J RETURN 

PUTJ SOSG OB+2 JADVANCE BYTE COUNTER 

P'ijr. inll ^^lo^ '^^^'' ^^ ^^^''^ ^^^^ <0R •'IRST CALL) 

PJTC: IDPB C,0B + 1 JPUT BYTE INTO BUFFER " - i- / 

-•RST (A) JRETURN TO CALLER 

JJUMP HERE WHEN BUFFER IS KUUL AMD THE NEXT ONE IS NEEDED 
?GIVE THE MONITOR THE BUFFER AND JUMP BACK "NttutU 

PUTBF! OUT 0, IGlMi: BUFFER TO MONITOR 

JRST PUTC JNO ERRORS--JUMP BACK 

MOVEM C,SAVEC# ;ERR0R— SAVE AC FOR STATUS CHtCKlMG 
GETSTS 0,0 ,GET ERROR STATUS 

M» INSERT OUTPUT ERROR ROUTINE HLRE 

I FOK EXAMPLE, TYPE C IN OCTAL " 

; i-inn message giving file name, etc, 

TRH C,/4g23 iCLEAR ERROR BITS 

SETSTS 0,(C> ITELL MONITOR 

MOVE CSAVEC IRESTORE CHARACTER 

^^^^ PUTC IJUMP BACK TO PROCESS CHARACTER 

4.5.3 Synchronization of Buffered I/O 

In some instances, such as recovery from transmission errors, it is desirable to delay until a device 
completes its I/O activities. The programmed operator 

WAIT D, or CALL! D, 10 
returns control to the user's program when all data transfers on channel D have finished. This UUO 
does not wait for a magnetic tape spacing operation, since no data transfer is in progress. An 
MTAPE D, (refer to Paragraph 5.5.3) should be used to wait for the magnetic tape controller to be 
freed after completing spacing and I/O activity on magnetic tape. In addition, the UUO does not 
wait for physical I/O to the terminal to be completed; it waits only until the user's buffer is empty. 
Therefore, the usual motive for the WAIT UUO, error recovery, does not apply to the terminal. If no 
device is associated with data channel D, control returns immediately. After the device is stopped, 
the position of the device relative to the data currently being processed by the user's program can be 
determined by the buffer use bits. 
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The file status is a set of 18 bits (right-half word), which reflects the current state of a file trcnsmis- 
sion. The initial status is a parameter of the INIT and OPEN operators. Thereafter, bits are set by 
the monitor, and may be tested and reset by the user via the STATZ, STATO, and SETSTS monitor 
programmed operators. Table 4-3 defines the file status bits. All bits, except the end-of-file bit, 
are set immediately by the monitor as the conditions occur, rather than being associated with the buffer 
currently being used. However, the file status is stored with each buffer so that the user can deter- 
mine which bufferful produced an erroro The end-of-file bit is set when the user attempts to read past 
the last block of data (i.e., it is set on an IN or INPUT UUO for which there is no corresponding data; 

Table 4-3 
File Status Bits 



Bit 


Meaning 


18 


Improper mode (lO.IMP). Attempt to write on a software write-locked 
tape or file structure, or a software detected redundancy failure occurred. 
Usually set by monitor. 


19 


Hard device detected error (lO.DER), other than data parity error. This 
is a search, power supply, or channel memory parity error. The device is 
in error rather than the data on the medium. However, the data read into 
core or written on the device is probably incorrect. Usually set by monitor. 


20 


Hard data error (lO.DTE). The data read or written has incorrect parity 
as detected by hardware (or by software on CDR, PTR). The user's data 
is probably non -recoverable even after the device is fixed. Usually set 
by monitor. 


21 


Block too large (lO.BKT). A block of data from a device is too large to 
fit in a buffer; a block number is too large for the unit; the file structure 
(DSK) or unit (DTA) has filled; or the user's quota on the file structure has 
been exceeded. Usually set by monitor. 


22 


End of file (lO.EOF). The user program has requested data beyond the last 
record or block with an IN or INPUT UUO, or USETI has specified a block 
beyond the last data block of the file. When set, no data has been read in- 
to the input buffer. Usually set by rrionitor. 


23 


I/O active (lO.ACT). The device is actively transmitting or receiving data. 
Always set by monitor. 


24-29 


Device dependent parameters. Refer to Chapters 5 and 6 and Appendix D for 
detailed information about each device. Usually set by user. 


30 


Synchronous input (lO.SYN). Stops the device after each buffer is filled. 
Usually set by user. 


31 


User word count (lO.UWC). Forces the monitor to use the word count in the 
third word of the buffer (oulput only). The monitor normally computes the word 
count from the byte pointer in the buffer header. Usually set by user. 


32-35 


Data mode (lO.MOD). Refer to Tables 4-1 and 4-2. Usually set by user. 
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the previous IN or INPUT DUO obtained the end of the data). Therefore, when this bit is set, no data 
has been placed in the input buffer. 

The programmed operators discussed in this section are the software equivalents of the hardwired in- 
structions CONO, CONI, CONSO, and CONSZ. A more thorough description of bits 18 through 29 
for each device is given in Chapters 5 and 6 and in Appendix D. 

4.6.1 File Status decking 

The file status (refer to Table 4-3) is retrieved by the GETSTS (operation code 062) and tested by the 
STATZ (operation code 063) and STATO (operation code 061) programmed operators. In each case, 
the accumulator field of the instruction selects a data channel . If no device is associated with the 
specified data channel , the monitor stops the job and prints 

I/O TO UNASSIGNED CHANNEL AT USER addr 

(oddr is the location of the GETSTS, STATZ, or STATO programmed operator) on the user's terminal 
and the terminal is left in monitor mode. 

GETSTS D,E stores the file status of data channel D in the right half and in the left half of loca- 
tion E„ 

STATZ D,E skips, if all file status bits selected by the effective address E are 0. 

STATO D,E skips, if any file status bit selected by the effective address E is 1 . 

4.6.2 RIe Status Setting 

The initial file status is a parameter of the INIT and OPEN programmed operators; however, the file 
status may be changed by the SETSTS (operation code 060) programmed operator. Error status bits 
lO.ERR (lO.IMP, lO.DER, lO.DTE, and lO.BKT) must be cleared by this programmed operator if the 
user is attempting an error recovery. In addition, the SETSTS UUO can be used to clear the end-of- 
file bit, but this is not sufficient to clear the end-of-file condition. Further inputs will not occur un- 
til the end-of-file condition (determined by an internal monitor flag lOEND) is cleared by a CLOSE 
or INIT UUO. 

SETSTS D,E waits until the device on channel D stops transmitting data and replaces the current file 
status, except bit 23, with the effective address E. If the new data mode, indicated in the right four 
bits of E, is not legal for the device, the job is stopped and the monitor prints 

ILL DEVICE DATA MODE FOR DEVICE dev AT USER addr 

(dev is the physical name of the device and addr is the location of the SETSTS operator) on the user's 
terminal and the terminal is left in monitor mode. If the user program changes the data mode, it must 
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also change the byte size for the byte pointer in the input buffer header (if any) and the byte size and 
item count in the output buffer header (if any). The output item count should be changed by using the 
count already placed there by the monitor and dividing or multiplying by the appropriate conversion 
factor, rather than assuming the length of a buffer. Incorrect I/O may resujt if a data mode change 
requires a different buffer length. SETSTS does not change buffer lengths. The mode specified in the 
INIT is used to determine buffer sizes even though the buffer ring has not been created. 

4.7 RLE TERMINATION 

File transmission is terminated by the CLOSE D,N (operation code 070) programmed operator. N is 
usually zero, but individual options may be selected independently to control the effect of the CLOSE. 

Usually a given channel is OPEN for file transmission in only one direction, and CLOSE has the effect 
of either closing input if INPUTs have been done or closing output if OUTPUTs have been done. How- 
ever, disk and DECtape may have a single channel OPEN for both INPUT and OUTPUT, in which case 
the first two options below are useful . 

4.7.1 CLOSE D,0 

The output side of channel D is closed (bit 35=0). In unbuffered data modes, the effect is to execute 
a device dependent function. In buffered data modes, if a buffer ring exists, the following operations 
are performed: 

a. All data in the buffers that has not been transmitted to the device is written. 

b. Device deperident functions are performed. 

c. The ring use bit (bit of the first word of the buffer header) is set to 1 indicating that 
the buffer ring is available. 

d. The buffer byte count (the third word of the buffer header) is set to 0. 

e. Control returns to the user program when transmission is complete. 

The input side of channel D is also closed (bit 34=0). The end-of-file flag is always cleared. Further 
action depends on the data mode in unbuffered data modes, the effect is to execute a device dependent 
function. In buffered data modes, if a ring buffer exists, the following operations are performed: 

a. Wait until device is inactive. 

b. The use bit of each buffer (bit of the second word) is cleared indicating that the buffer 
is empty. 

c. The ring use bit of the buffer header (bit of the first word of the buffer header) is set to 
1 indicating that the buffer ring is available. 

d. The buffer byte count (the third word of the buffer header) is set to 0. 

e. Control returns to the user program. 
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On output CLOSE, the unwritten blocks at the end of a disk file are automatically deallocated (bit 
33=0) i On input CLOSE, the access date of a disk file is updated (bit 32=0). 

4.7.2 CLOSED,! (Bit 35=1, a. OUT) 

The closing of the output side of channel D is suppressed. Other actions of aOSE are unaffected. 

4.7.3 CLOSE D,2 (Bit 34=1, CL.IN) 

The closing of the input side of channel D is inhibited; other actions of CLOSE are unaffected. 

4.7.4 aOSE D,4(Bit33=l, a.DLL)^ 

The unwritten blocks at the end of a disk file are not deallocated. This capability is provided for 
users who specifically allocate disk space and wish to retain it. 

4.7.5 CLOSE D,10 (Bit 32=1, CL.ACS)^ 

The updating of the access date on CLOSE input is inhibited. This capability is intended for use with 
FAILSAFE, so that files can be saved on magnetic tape without causing the disk copy to appear as if it 
has been accessed . 

4.7.6 CLOSE D,20 (Bit 31=1, CL.NMB)^ 

I The deleting of the NAME block and the access tables in monitor core on CLOSE input is inhibited if 
LOOKUP was done without subsequent INPUT. This bit is used by the COMPIL program to retain the 
block in order to speed up the subsequent access by the system program called by COMPIL. 



a 
core 



4.7.7 CLOSE D,40 (Bit 30=1 , a.RST)^ 

The deleting of the original file, if any, is inhibited if an ENTER which creates or supersedes was 
done. Tlie new copy of the file is discarded. This bit is used by the queue manager (QMANGR) to 
create a file or a unique name and not supersede the original file. 

4.7.8 CLOSE D,100 (Bit 29=1 ,CL. DAT) t 

I The NAME block and access tables are deleted from the disk data base and the space is returned to 
free core. 



t Meaningful with disk files only, ignored with non-disk Hies. 
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Example: TerminaHng a File 
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DROPDV: 

CLOSE 3* 

STATZ 3* 740000 

JRST OUTERR 
RELEAS 3* 

MOVE 0* SVJBFF 
MOVEM 0* JOBFF 
JRST @ DROPDV 



JSR HERE 

WRITE END OF FILE AND TERMINATE 
INPUT 

RECHECK FINAL ERROR BITS 
ERROR DURING CLOSE 
RELINQUISH THE USE OF THE 
DEVICE, WRITE OUT THE DIRECTORY 

RECLAIM THE BUFFER SPACE 
RETURN TO MAIN SEQUENCE 



4.8 DEVICE TERMINATION AND REASSIGNMENT 

4.8.1 RELEASE 

When all transmission between the user's program and a device is finished, the program must relinquish 
the device by performing a 

RELEASE D, 

RELEASE (operation code 071) returns control immediately, if no device is associated with data chan- 
nel D. Otherwise, both input and output sides of data channel D are CLOSEd and the correspondence 
between channel D and the device, which was established by the INIT or OPEN programmed operators, 
is terminated. Any errors that occurred are recorded in the BAT block if a super USETl/USETO was 
used with channel D. If the device is neither associated with another data channel nor assigned by the 
ASSIGN or MOUNT monitor command, it is returned to the monitor's pool of available facilities. 
Control is returned to the user's program. 

4.8.2 RESDV. AC, or CALLI AC, 117 

This UUO allows a user program to reset a single channel. It is similar to the RELEASE UUO except 
any files and buffers are not closed. Files that are open on the channel are deleted; any older ver- 
sion with the same filename remains. All I/O transmissions on the channel are stopped, and device 
allocations made by the INIT or OPEN UUOs on the specified channel are cleared. The device is re- 
turned to the monitor pool unless it has been assigned by the ASSIGN or MOUNT monitor command. 
The call is: 

MOVEI AC, channel number 

RESDV. AC, ; or CALLI AC, 1 17 

error return 

norma! return 
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On an error refurn, eifher the AC is unchanged If the UUO is not implemented, or AC contains -1 if 
there is no device associated with the channel . 

On a normal return, the channel is reset. 

4.8.3 REASSIGN AC, or CALLI AC, 21 

This UUO reassigns a device under program control to the specified job and clears the directory cur- 
rently in core, but does not clear the logical name assignment. A device can be reassigned if it is as- 
signed to the current job, or if it is both not assigned to any job and is not detached. A RELEASE UUO 
is performed unless the job issuing the UUO is reassigning the device to itself by specif/ing -1 in AC 
or is deassigning the device by specifying in AC. If the device is restricted when it is deassigned with 
o in AC, it is returned to the restricted pool of devices and can be reassigned to a non -privileged I'ob 
by a privileged job. (This is the method by which the MOUNT command is implemented.) 

The call is: 

MOVE AC, |ob number 

MOVE AC+1 , C SIXBIT /DEVlCE/1 ;or MOVEI AC+1 , channel number 

REASSIGN AC, ;or CALLI AC, 21 

return ; error and normal 

If on return the contents of AC == 0, the specified job has not been initialized. If the contents of 
AC+1=0, the device has not been assigned to the new job, the device is the job's controlling terminal , 
the logical name is duplicated, or the logical name is a physical name in the system and the job reas- 
signing the device is either logged in under a different project-programmer number or is not the operator. 

4.8.4 DEVLNM AC, or CALLI AC, 107^ 

This UUO sets the logical name for the specified device. Upon call of the UUO, AC contains either 
the device name or the channel number associated with the device. The call is: 

MOVE AC, [SIXBIT /dev/] ;or MOVEI AC, channel no. 

MOVE AC+1 , [SIXBIT /log .name/] 

DEVLNM AC, ;or CALLI AC, 107 

error return 

normal return 

On an error return, AC contains one of the following: 

AC = unchanged if the UUO is not implemented. 

AC = -1 if a non-existent device or channel number was specified . 

AC = -2 if the logical name is already in use. 

I AC = -3 if device is neither assigned by a console command (ASSIGN, 

MOUNT) nor by the program (INFT, OPEN). 

On a normal return, AC and AC+1 are unchanged. 



This UUO depends on FT5UUO which is normally off in the DECsystem-1040, 
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4.9 EXAMPLES 

4.9.1 File Reading 

The following UUQ sequence is required to read a file: 



MONITOR CALLS 



OPEN 
LOOKUP 
INBUF 
INPUT 



Establishes a file structure-channel correspondence (or o 
set of file structure channel correspondences). 

Establishes a file-channel correspondence. Invokes 

a search of the UFD. Returns information from the file system. 

(Optional) Sets up 1 to N ring buffers in the top of core, 
expand core if necessary. 

Sets up 2-buffer ring if no INBUF was done. 



INPUT 
CLOSE 
RELEASE 



Requests buffers of data from the monitor. 
Breaks file-channel correspondence. 
Breaks device-channel correspondence. 



4.9.2 File Writing 

The following UUO sequence is required to write a file: 



OPEN 



ENTER 



OUTPUT 



Forms file structure-channel correspondence (or a set 
of file structure channel correspondences). 

Forms file-channel correspondence. The monitor creates 
some temporary storage for interlocking and shared access 
purpose for the filename. No directory entry is made. 



OUTPUT 



CLOSE 



RELEASE 



Passes buffers of data to monitor for transmission to storage device. 
Should not be used for the final buffer because CLOSE completes 
the action of ENTER. 

Completes the action of ENTER. Adds filename to file system. 
Normally returns allocated, but unused, blocks to the file 
system . 

Breaks device-channel correspondence. 



4-25 



MONITOR CALLS 

4.9.3 RIe Reodlr^A/rlflng 



-^86- 



TITLE 



FILTRN -- SAMPLE I/O PROGRAM 



JA PROGRAM THAT READS 7-BIT ASCII CHARS FROM FILE INFILE.DAT 

JON DEVICE DATA AND OUTPUTS THEM TO FILE OUTFIL.LST ON DEVICE LIST 

iNOTE THAT DEVICES DATA AND LIST ARE LOGICAL NAMES. THUS 

JTHE PHYSICAL NAMES ARE DETERMINED AT RUN TIME TO PROVIDE DEVICE 

J INDEPENDENCE. 

IBOTH INPUT AND OUTPUT FILES ARE ACCESSED SEQUENTIALLY. 



START: RESET 
OPEN 



HALT 
OPEN 



HALT 
LOOKUP 

HALT 
ENTER 

HALT 
INBUF 



JDEVICE RESET (IN CASE PROGRAM 

i IS RESTARTED) 
y»i 1 iCONNECT DEVICE DATA TO PROG ON CH 1 

SIXBIT /DATA/ 
XWD 0*IBUF13 IINBUFI IS THE INPUT BUFFER HEADER 

TERROR RETURN 

ICONNECT DEVICE LIST TO CH 2 



2*t 1 

SIXBIT /LIST/ 
XWD OBUF2«0] 

1#L1 

2,E2 

1^3 



I0BUF2 IS OUTPUT BUFFER HEADER 

JOPEN FILE INFILE.DAT FOR INPUT 

* ERROR RETURN 

lOPEN FILE OUTFIL.LST FOR OUTPUT 

ICREATE 3 INPUT BUFFERS 

ISINCE NO BUFFERS SPECIFIED FOR OUTPUT 
J ON FIRST OUTPUT THE MONITOR WILL 
I MAKE 2 



JTHIS IS THE BASIC I/O LOOP FOR THE JOB 



::hr: 


JSR 


GET 




JSR 


PUT 




JRST 


NEWCHR 



J GO GET ONE INPUT CHARACTER 
IGO PUT THE CHARACTER RECEIVED 
I LOOP FOR NEXT ONE 



IGET -- ROUTINE TO GET ONE CHARACTER FROM THE INPUT 
JIT ENDS THE PROGRAM AT INPUT END-OF-FILE 



GET: 


Z 




GETl : 


SOSGE 


IBUFl+2 




JRST 


GETBF 




ILDB 


3*IBUF1+1 




JUMPE 


3#GET1 



JRST 



©GET 



GETBF : 


IN 


I, 




JRST 


GET I 




STATZ 


W74B23 




HALT 


. 


FINISH: 


CLOSE 


I* 




CLOSE 


2, 




RELEAS 


\» 




RELEAS 


2, 




EXIT 





JENTRY/EXIT 

J IS INPUT BUFFER EMPTY? 

IYES--INPUT FROM DEVICE 

IGET A CHARACTER FROM INPUT BUFFER 

J IF NULL* THROW IT AWAY AND GET NEXT 

J CHARACTER. THIS IS CONVENTIONAL FOR 

J ASCII DATA. 

JRETURN WITH CHARACTER IN AC 3 

JDO INPUT FROM DEVICE 
ILOOP IF NO ERRORS AND NOT EOF 
JSEE IF ERROR READING 
JYES--GIVE UP 

JEOF--CLOSE INPUT 
JCLOSE OUTPUT 
JRELEASE DEVICE DATA 
IRELEASE DEVICE LIST 
JEXIT TO MONITOR 



(conHnued on next page) 



5.04 Monitor 



4-26 



January 1972 



-^87- 

iPUT--ROLiTIN¥ TO PUT ONE CHAHA€TEK • ONTO THE OUTPUT 
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PUT: 
PUTC: 


Z 

SOSG 
JRST 
IDPB 
JRST 


0BUF2+2 
PUTBF 
3*0BUF2+1 
©PUT 


PUTBF: 


OUT 

JRST 
HALT 


2, 
PUTC 


;OATA 


STORAGE AREA 


LI : 


SIXBIT 

SIXBIT 

Z 

Z 


/INFILE/ 
/DAT/ 


E2: 


SIXBIT 

SIXBIT 

Z 

Z 


/OUTFIL/ 
/LST/ 


IBUFl : 
0BUF2: 


BLOCK 
BLOCK 


3 
3 



;entry/exit 

US OUTPUT BUFFER FULL? 
iYES--GO OUTPUT IT 
;PUT CHARACTER IN BUFFER 
JRETURN 

lOUTPUT BUFFER TO DEVICE 

;0K, NOW STORE CHARACTER IN BUFFER 

iGIVE UP IF OUTPUT ERROR 



i INPUT FILE NAME 

J INPUT EXTENSION 

;PROTECTION AND CREATION DATE RETURNED 

; INPUT DIRECTORY. MEANS MY OWN 

jOUTPUT FILE NAME 

; OUTPUT EXTENSION 

iPROTECTION CAN GO HERE. MEANS STD. 

5 OUTPUT DIRECTORY. MEANS MY OWN 

5 INPUT BUFFER HEADER 
^OUTPUT BUFFER HEADER 



END 



START 



4.10 DEVICE INFORMATION 
4.10.1 DEVSTS AC, or CALLI AC, 54 



This UUO retrieves the DEVSTS word of the device data block for an INITed device. The DEVSTS 
word is used by a device service routine to save the results of a CONI after each interrupt from the 
device. Refer to Appendix D for the device status bits. Devices that use the DEVSTS UUO are the 
following: CDR, CDP, MTA, DTA, PTR, PTP, DSK, LPT, and PLT. 



The call is: 



MOVEI AC, channel number of device 
DEVSTS AC, 
error return 
normal return 



;orMOVEAC, [SIXBIT /dev/] 

;or CALLI AC, 54 

;UUO not implemented for any devices 

;AC contains the DEVSTS 

;wordof the DDB. 



On return, the contents of the DEVSTS word Is returned in AC. Therefore, if the device service rou- 
tine does not store a CONI, useless information may be returned to user. Note that an error return is 
not indicated if the device service routine does not use the DEVSTS word for its intended purpose. De- 
vices with both a control and data interrupt store the controller CONI (MTS, DTS, DSK, DSK2, DPC, 
DPC2). 



^ This UUO depends on FT5UUO which is normally off in the DECsystem-1040. 
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The DEVSTS UUO is not meaningful when used in asynchronous buffered l/O mode unless a WAIT DUO 
(see Paragraph 4.5.3) is issued first to ensure synchronization of the actual data transferred with the 
device status returned. 



4.10.2 DEVCHRACorCALLIAC, 4 

This UUO allows the user to determine the physical characteristics associated wifh a device name. 
When the UUO is called, AC must contain either the logical or physical device name as a left-|ustified 
SIXBIT quantity, or the channel number of the device as a right-justified quantity. 



The call is: 



MOVE AC, [SIXBIT/DEV/I 

DEVCHRAC, 

return 



;or MOVEI AC, channel number of device 
;orCALLI AC,4 



If the device is not found or the channel is not INITed, the contents of AC is zero on return. If the 
device is found, the following infonnation is returned in AC. 



Name 



DV.DRI 



DV.DSK 


Bit 1 = 1 


DV.CDR 


Bit 2 = 1 


DV.LPT 


Bit 3 = 1 


DV.TTA 


Bit 4 = 1 


DV.TTU 


Bit 5 = 1 


DV.TTB 


Bit 6 = 1 


DV.DIS 


Bit 7 = 1 


DV.LNG 


Bit 8 = 1 


DV.PTP 


Bit 9 = 1 


DV.PTR 


Bit 10 = 1 


DV.DTA 


Bit 11 =1 


DV.AVL 


Bit 12 = 1 


DV.MTA 


Bit 13 = 1 


DV.TTY 


Bit 14 = 1 


DV.DIR 


Bit 15 = 1 



Bit 



Bit = 1 



Explanation 



DECtape directory is in core. This bit is cleared by an ASSIGN 
or DEASSIGN to that unit. 

Device is a disk. 

Device is a card reader (DV.IN = 1) or card punch (DV.OUT 
= 1). 

Device is a line printer. 

TTY is controlling a job. 

TTY is in use as a user terminal (even if detached). 

Free bit left from SCNSRF. 

Device is a display. 

Device has a long dispatch table (that is, UUOs other than 
INPUT, OUTPUT, CLOSE, and RELEASE perform real actions). 

Device is a paper-tape punch. 

Device is a paper-tape reader. 

Device is a DECtape. 

Device is available to this job or is already assigned to this job. 

Device is a magnetic tape. 

Device is a TTY . 

Device has a directory (DTA or DSK). 



(continued on next page) 
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Name 



DV.IN 
DV.OUT 
DV.ASG 
DV.ASP 



Bif 



ExplanaHon 



Bit 16 = 1 

Bit 17 = 1 

Bit 18 = 1 

Bit 19 = 1 

Remaining 
bits 



Device can perform input. 

Device can perform output. 

Device is assigned by a console command. 

Device is assigned by program (I NIT or OPEN). 

If bit 35-n contains a 1 , then mode n is legal for that device. 
The mode number (0 through 17) must be converted to decimal 
(e.g., mode 178 is represented by bit SS-lS^oor bit 20). 



I 4.10.3 DEVTYP AC, or CALLI AC, 53 



The device-type UUO is used to determine properties of devices. This UUO accepts, as an argument, 
a device name in SIXBIT or a right-justified channel number. The call is: 



MOVE AC, [SIXBIT/dev/1 
DEVTYP AC, 
error return 
normal return 



;or MOVEI AC, channel no. 
;or CALLI AC, 53 



The error return is given if the UUO is not implemented. In this case, the DEVCHR UUO should be 
used. On a normal return, if AC=0, the specified device does not exist or the channel is not INITed. 
If the device exists, the following information is returned in AC. 



Name 



TY.MAN 

TY.AVL 
TY.SPL 

TY.INT 
TY.VAR 

TY.IN 

TY.OUT 

TY.JOB 



Bit 



Explanation 



Bit = 1 
Bits 1-11 
Bit 12 = 
Bit 13 = 

Bit 14 = 
Bit 15 = 

Bit 16 = 
Bit 17 = 
Bits 18-26 



LOOKUP/ENTER mandatory. 
Reserved for the future . 
Device is available to this job. 

Spooled on disk. (Other bits reflect properties of real 

device, except variable buffer size.) 

Interactive device (output after each break character). 

Capable of variable buffer size (user can set his own 
buffer lengths). 

Capable of input. 

Capable of output. 

Job number that currently has device INITed or 
ASSIGNed. 



(continued on next page) 
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Name 



TY .RAS 
TY .DEV 



Bif 



Bits 27-28 
Bit 29 

Bits 30-35 



Explanation 



Reserved for the future. 

Device is a restricted device (i.e., can be assigned 
only by a privileged iob or the MOUNT command). 

Device type code. 



Code ( 
Code 1 ( 
Code 2 ( 
Code 3 ( 
Code 4 ( 
Code 5 ( 
Code 6 ( 
Code 7 ( 
Code 10 
Code 1 1 
Code 12 
Code 13 
Code 14- 
Code 60 



.TYDSK) 

.TYDTA) 

.TYMTA) 

.TYTTY) 

.TYPTR) 

.TYPTP) 

.TYDIS) 

.TYLPT) 

(.TYCDR) 

(.TYCDP) 

(.TYPTY) 

(.TYPLT) 

■57 



-77 



Disk of some sort 

DECtape 

Magnetic tape 

TTY or equivalent 

Paper-tape reader 

Paper-tape punch 

Display 

Line printer 

Card reader 

Card punch 

Pseudo-TTY 

Plotter 

Reserved for Digital 

Reserved for customer 



4. 10.4 DEVSIZ AC, or CALLI AC, 101 

This UUO is used to determine the buffer size for a device if the user wants to allocate core himself. 
The call is: 



MOVE AC, [EXPLOC] 
DEVSIZ AC, 
error return 
normal return 



LOC: EXP STATUS 
LOC+l:SlXBIT/dev/ 



;or CALLI AC, 101 



;first word of the OPEN block 
;second word of the OPEN block 



The error return is given if the UUO is not implemented. On a normal return, AC contains one of 
the following values: 

If the mode is illegal, AC contains -2. 

If the device does not exist, AC contains -1. 

If the device exists, but its data mode is dump mode, AC contains 0. 

If the device exists and the data mode is legal, AC contains in bits 
0-17 the default number of buffers, and in bits 18-35 the default buf- 
fer size (including the first three words of the buffer). 
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4.10.5 WHERE AC, or CALLI AC, 63^ 

This UUO returns the physical station number of the specified device. When the UUO is called, 

AC contains either the channel number of the device as a right-justified quantity, or the device name 

as a I eft- justified SIXBFT quantity. The call is: 

MOVE AC, CSIXBlT/dev/l ;or MOVEI AC, channel no. 

WHERE AC, ;or CALLI AC, 63 

error return 
normal return 

If OPR is specified as the device name, the station number at which the job is logically located is 
returned; if OPRO is specified, the station number of the central station is returned; and if TTY is 
specified, the station number at which the job's TTY is located is returned. 

On a normal return, the LH of AC contains the station's status, and the RH of AC contains the station 
number associated with the device. The station's status is represented by the following bits: 



Bit 13 = 
Bit 14 = 
Bit 15 = 
Bit 16 = 
Bit 17 = 



if the station is dial-up (RM.SDU). 

if the station is loaded (.RMSUL). 

if the station is in the loading procedure (.RMSUG). 

if the station is down (.RMSUD). 

if the station is not in contact (.RMSUN). 



The error return is taken if the UUO is not implemented, the specified channel is not INITed, or the 
requested device does not exist. 

4.10.6 DEVNAM AC, or CALLI AC, 64 

This UUO returns the physical name of a device obtained through either a generic INIT/OPEN or a 
logical device assignment. When the UUO is called, AC contains either channel number of the de- 
vice as a right-justified quantity, or the device name as a left-justified SIXBIT quantity. The call is: 

MOVE AC, [SIXBIT /dev/1 ;or MOVEI AC, channel no. 

DEVNAM AC, ;or CALLI AC, 64 

error return 
normal return 

The normal return is taken if the specified device is found, and AC contains the SIXBIT physical 
device rwme. 

The error return is taken if the UUO is not implemented (AC is unchanged), the specified channel 
is not INITed, or no such device exists. 



1 



This UUO depends on FTREM which is normally off in the DECsystem-1040. 
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CHAPTER 5 

I/O PROGRAMMING FOR 

NONDIRECTORY DEVICES 



This chapter explains the unique features of each standard nondirectory I/O device. Each device 
accepts the programmed operators explained in Chapter 4, unless otherwise indicated. Table 5-1 is a 
summary of the characteristics of all nondirectory devices. Buffer sizes are given in octal and include 
three bookkeeping words. The user may determine the physical characteristics associated with a logi- 
cal device name by calling the DEVCHR UUO (refer to Paragraph 4. 10.2). 



Table 5-1 
Nondirectory Devices 



Device 


Physical 
Name 


Controller 
Number 


Unit 
Number 


Programmed 
Operators 


Data 
Modes 


Buffer 

Size 

(Octal)t 


Card Punch 


CDP 


- 


CPIOA 


OUTPUT /OUT 


A,AL,I,IB,B 


35 


Card Reader 


CDR^CDRl 


- 


CRIOA 
461 (PDP-6) 


INPUT, IN 


A,AL,I,IB, 
B,SI 


36 


Console 
Terminal 


CTY 




LT33A, LT33B 
LT35A,LT37AC 
626 (PDP-6) 


INPUT, IN 
OUTPUT, OUT 


A,AL, I 


23 


Display 


DIS 


- 


VR30, VPIO 
340B, 30 


INPUT, OUTPUT 


ID 


Dump only 


Line Printer 


LPT,LPT1 




LP IOC 


OUTPUT 


A,AL, I 


37 


Magnetic 
Tape 


MTAO^MTAlj 
. . . , MTA7 


TMIOA 
TMIOB 
516(PDP-6) 


TU20A,TU20B 
TU30AJU30B 


INPUT, IN 
OUTPUT, OUT 
MTAPE 


A, AL, I 
IB, B 
DR, D 


203 tt 


Pa per -Tape 
Punch 


PTP 


- 


PC09 

761 (PDP-6) 


OUTPUT, OUT 


A,AL, I 
IB, B 


43 


Paper-Tape 
Reader 


PTR 


- 


PC09 
760(PDP-6) 


INPUT, IN 


A, AL, I 
IB, B 


43 


Buffer sizes are subject to 
DEVSIZ UUO may be empi 
"'"■''The buffer size for magnt 
to the DECsystem-10 Oper< 


change and 
oyed. 

3tic tape mo) 
jting System 


should be calculc 

f be changed wit! 
Commands). 


Jted rather than ass 
1 the SET BLOCKS 


.umed by user pr 
ZE monitor com 


ograms. A 
mand (refer 
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Table 5-1 (Cont) 
Nondirectory Devices 



Device 


Physical 
Name 


Controller 
Number 


Unit 
Number 


Programmed 
Operators 


Data 
Modes 


Buffer 

Size 

(Octal)"^ 


Plotter 

Pseudo-TTY 

Terminal 


PLT 

PTY 

TTY0,TTY1, 
...,TTY177 


XYIO 

DCIO 

DC68A 

630(PDPhS) 


XYIOA 
XYIOB 

LT33A,LT33B 

LT35A,LT37AC 

VT06 


OUTPUT, OUT 

INPUT, IN 
OUTPUT, OUT 

INPUT, IN 
OUTPUT, OUT 
TTCALL 


A, AL, I 
IB, B 

A, AL 
A, AL, I 


46 
23 
23 


'"Buffer sizes 
DEVSIZ UU< 


are subject to change and 
D may be employed. 


should be calcula 


ted rather than assumed by user programs. A 



5.1 CARD PUNCH 

The device mnemonic is CDP; the buffer size is dependent on the data mode. 

Data Mode Buffer Size 

A, AL 23_ (20o data) words - 80 7-bit ASCII characters 

8 o 

I, IB 36o (33q data) words - 80 12-bit bytes 

o o 

B 35o (32o data, 33o punched) words - 26 data words, 

8 8 o 

word count and checksum punched. 



5.1.1 Concepts 

The header card is the first card of an ASCII file and identifies the card code used (refer to Appendix C). 
This card is not punched for data modes other than ASCII. The header card has the same punches in all 
columns. This punch depends on the card code used; for example, in DEC026, the header card has 
12-2-4-8 punched in columns 1-80. 

The end-of-file (EOF) card is the last card of each output file. This card is punched for all data modes. 
The end-of-file card has a 12-11-0-1-6-7-8-9 punch in columns 1 through 80. 



5.1.2 Data Modes 

5.1.2.1 ASCII, Octal Code - ASCII characters are converted to cord codes and punched (up to 80 
characters per card). Tabs are simulated by punching from 1 to 8 blank columns; form-feeds and car- 
riage returns are ignored. 

5-2 
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Line-feeds cause a card to be punched. All other nontranslatabie ASCII characters cause a question 
mark to be punched. Cards can be split between buffers. Attempting to punch more than 80 columns 
per card causes the error bit lO.BKT (bit 21 of status word) to be set. The CLOSE will punch the last 
partial card and then punch an EOF card. 

Cards are normally punched with bEC026 card codes. If bit 29 (octal 100) of the status word is on 
(from INIT, OPEN, or SETSTS), cards are punched with DEC029 codes (refer to Appendix C). The 
first card of any file (the header card) indicates the card code used (12-0-2-4-6-8 punched in column 
1 for DEC029 card codes; 12-2-4-8 punched in column 1 for DEC026 card codes). 

5.1 .2.2 ASCII Line, Octal Code 1 ~ The same as ASCII mode. 

5.1 .2.3 Image, Octal Code 10 - In image mode, each buffer contains 27 words, each of which 
contains three 12-bit bytes. Each byte corresponds to one card column. Since there is room for 81 
columns in the buffer (3 x 27) and there are only 80 columns on a card, the last word contains only 2 
bytes of data; the third byte is thrown away. If the byte size is set by the program to be 12-bit bytes 
(the monitor normally sets 36-bit bytes), the program must skip the last byte in the buffer. Image 
binary causes exactly one card to be punched for each output. A program should not force an output 
every 80 columns since, if the program is in spooled mode, it will waste a large amount of disk space. 
The CLOSE punches the last partial card and then punches an EOF card. 

5.1.2.4 Image Binary, Octal Code 13 - Same as Image. 

5.1 .2.5 Binary, Octal Code 14 - Column 1 contains the word count in rows 12-3. A 7-9 punch is in 
column 1 . Column 2 contains a checksum as described for the paper-tape reader (refer to Paragraph 
5.7.1 .5); columns 3 through 80 contain up to 26 data words, 3 columns per word. Binary causes ex- 
actly one card to be punched for each output. The CLOSE punches the last partial card and then 
punches an EOF card. 

5.1.3 Special Programmed Operator Service 

Following a CLOSE, an EOF card is punched. Columns 2 through 80 of the header card and the EOF 
card contain the same punches that appear in column 1 of the respective card for easy file identifica- 
tion. These laced punches are ignored by the card reader service routine. 

After each Interrupt, the card punch stores the results of a CONI in the DEVSTS word of the device 
data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4. 10.1). 
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5. 1 .4 File Status (Refer to Appendix D) 

The file status of the card punch is shown below. 

Standard Bits 



18 21 24 27 30 33 35- 



ET BY USER 








1 


SET 

BY MONITOR 


19 


21 23 


"ILL 









Bit 19 -lO.DER 
Bit 21 -lO.BKT 
Bit 23 -lO.ACT 



Punch error 

Reached end-of-card with data remaining in buffer. 

Device is active. 



UNUSED 



18 20 22 24 27 



I 



Device Dependent Bits 



SET BY USER 



29 



Bit 29 - IO.D29 If 1, punch DEC029 card codes in ASCII mode. 

If 0, punch DEC026 codes. 



5.2 CARD READER 

The card reader device mnemonic is CDR; the buffer size is 36g (33g data) words. 



5.2.1 Concepts 

For ASCII input, a header card can be the first card of the file and identifies the card code used 
(DEC026 or ANSI standard). The header card is used only when changing from or back to installation 
standard on ASCII input. The header card must not be present with any other data modes; if present, 
the header card is treated as incorrect format or read as data. Refer to Appendix C for the card codes. 
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An EOF card may have one of three forms: 12-11-0-1 punched in column 1, 6-7-8-9 punched in 
column 1 , or a logical OR of the two punched in column 1 . Columns 2 through 80 are ignored. The 
EOF card has the same effect as the EOF key on the card reader. This key must be depressed or the 
end-of-file card must be present at the end of each input file for all data modes. 

To be compatible with PDP-11 operating systems, the DECsystem-10 card reader service accepts several 
other header card-code cards and EOF cards. Only column 1 is looked at; columns 2-80 are ignored. 

Punched by DECsystem-10 Also accepted 

EOF 12-11-0-1-6-7-8-9^ 12-11-0-1 

6-7-8-9 

DEC026 12-2-4-8 12-11-8-9''' 

ANSI 12-0-2-4-6-8 12-0-7-9 

5.2.2 Data Modes 

5.2.2.1 ASCII, Octal Code - All 80 columns of each card are read and translated to 7-bit ASCII 
code. Blank columns are translated to spaces. At the end of each card a carriage return/line feed is 
appended. As many complete cordis as can fit are placed in the input buffer, but cards are not split 
between two buffers. Using the standard-sized buffer, only one card is placed in each buffer. 

Cards are normally translated as DEC026 card codes (refer to PDP-10 System Reference Manual). If a 
DEC029 header card is encountered, any following cards are translated as DEC029 codes (refer to 
Appendix C) until the 029 conversion mode is turned off. The 029 mode is turned off either by a RELEASE 
command or by a DEC026 header card. Columns 2 through 80 of both of these cards are ignored. 

5.2.2.2 ASCII Line, Octal Code 1 -This mode is the same as ASCII mode. 

5.2.2.3 Image, Octal Code 10 - All 12 punches in all 80 columns are packed into the buffer as 12- 
bit bytes. The first 12-bit byte is in column 1 . The last word of the buffer contains columns 79 and 80 
as the left and middle bytes, respectively. The EOF button is processed as in ASCII mode. Cards are not 
split between two buffers. 

5.2.2.4 Image Binary, Octal Code 13 - This mode is the same as Image. 

5.2.2.5 Binary, Octal Code 14 - Card column 1 must contain a 7-9 punch to verify that the card is 
in binary format. Column 1 also contains the word count in rows 12 through 3. The absence of the 7-9 
punch results in setting the lO. IMP (bit 18 of status word) flag in the card reader status word. Card 
column 2 must contain a 12-bit checksum as described for the paper-tape binary format. Columns 3 
through 80 contain binary data, 3 columns per word for up to 26 words. Cards are not split between two 
buffers. The EOF button is processed the same as in ASCII mode. 

tt 

5.2.2.6 Super-Image, Octal Code 110 - Super-image mode may be initialized by setting bit 29 of 

the card reader's lOS word. This mode causes the 36 bits read from the I/O bus to be BLKI'd directly 
to the user's buffer. For this mode, the default size of the input buffer is 81 ,/> words (80^(-> data words). 

I These. cards are symmetric in the sense that the pattern of the punches is the same if the card is turned 
' j-iUpside down. 

This mode depends on FTCDRSI which is normally off in the DECsystem-1040. 
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5.2.3 Special Programmed Operator Service 

The card reader, after each interrupt, stores the results of a CONI in the DEVSTS word in the device 
data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4. 10. 1). 

5.2.4 File Status (Refer to Appendix D) 

The file status of the card reader is shown below. 

Standard Bits 

18 21 24 27 30 33 35 



SET BY USER 










1 
SET 
BY MONITOR 


8 


21 


24 




II 













Bit 18 -lO.IMP 

Bit 19-IO.DER 

Bit 20- lO. DTE 

Bit 22 -lO.EOF 
Bit 23 - lO.ACT 



7-9 punch absent in column 1 of a presumed binary card. 
The card reader is stopped. 

Photocell error, card motion error, data missed. The card 
reader is stopped. 

Computed checksum is not equal to checksum read on binary 
card. The card reader is stopped. 

EOF card read or EOF button pressed. 

Device is active. 



18 21 24 27 30 33 35 



UNUSED 



Device-Dependent Bits 



18 21 24 27 29 30 33 35 



SET BY USER 



Bit 29 -lO. SIM Super-Image mode , 
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5.3 DISPLAY WITH LIGHT PEN 

The device mnemonic is DIS; there is no buffer because the display uses device-dependent dump mode 
only. 

5.3.1 Data Modes 

For IMAGE DUMP, Octal Code 15, an arbitrary length in the user area may be displayed on the scope. 
The command list format is as described in Chapter 4 with the addition for the Type 30/ VR30 and VPIO 
display, that, if RH = 0, and LH / 0, then LH specifies the intensity for the following data (4 to 13). 

5.3.2 Background 

During timesharing on a heavily-loaded system, the monitor service routine for the Type 30, VR30, 
and VPIO guarantees a flicker-free picture on the display if the job is locked in core. To maintain 
this picture, the picture data must be available for the display at least every two jiffies. If the system 
is lightly loaded, it is not necessary to keep the job in core. When the fob is swapped, a minimum 
amount of flicker may occur, but the job has high priority to be swapped-in again. 

5.3.3 Display UUOs 

The I/O UUOs for both displays operate as follows: 



INIT D, 15 

SIX BIT /DIS/ 



ERROR RETURN 

NORMAL RETURN 

CLOSED, 

or 
RELEAS D, 



MODE 15 ONLY 
DEVICE NAME 
NO BUFFERS USED 
DISPLAY NOT AVAILABLE 

STOPS DISPLAY AND 
RELEASES DEVICE AS 
DESCRIBED IN CHAPTER 4 



5.3.3. 1 INPUT D, ADR - If a light pen hit has been detected since the last INPUT command, then 
C(ADR) is set to the location of last light pen hit. If no light pen hit has been detected since last 
INPUT command, then C(ADR) is set to -1. 

5.3.3.2 OUTPUT D, ADR - ADR specifies the first address of a table of pointers. This table is 
composed of pointers with the following format: 

17 18 35 



LH 



RH 
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For the Type 30, VR30 and VPIO Display: 

If LH = and RH = 0, then this is the end of the command list. 

If LH /O and RH = 0, then LH is the desired intensity for the following data or commands. 
The intensity ranges from 4 to 13, where 4 is the dimmest and 13 is 
the brightest. 

If LH = and RH / 0, then RH is the address of the next pointer. Successive pointers are 
interpreted beginning at RH. 

If LH j<^0 and RH ^0, then -LH words beginning at address RH + 1 are output as data to 
the display. The format of the data word is the following: 



E 



7 8 



17 18 



25 26 



35 



y- coord 



E] 



For the Type 340B Display: 

If RH = 0, then this is the end of the command list. 

If LH = and RH/ 0, then RH is the address of the next pointer. Successive pointers are 
interpreted beginning at RH. 

If LH /O and RH ?^0, then -LH words beginning at address RH+1 are output as data to the 
display. The format of the data word is described in the Precision 
Increm en tal CRT Display Type 340 Maintenance Manual . 

An example of a valid pointer list for the VR-30 display is: 



OUTPUT 


D^ LIS' 


r 


LIST* 


XWD 


5^ 




lOWD 


1 , A 




lOWD 


S^SUBPl 




XWD 


1 3^0 




lOWD 


1 ^C 




lOWD 


2^SUBP2 




XWD 


0. LISTl 


LISTl : 


XWD 


10*0 




lOWD 


1 *B 




lOWD 


1 :.D 




XWD 


0*0 




OUTPUT 


D* LIST 


A : 


XWD 


6* 6 


8 : 


XWD 


70*105 


C: 


XWD 


10 5*70 


D: 


XWD 1000^200 


SUBPl : 


BLOCK 


5 


SUBg: 


BLOCK 


2 



*OUTPUT DATA 

^POINTED TO BY LIST 

* INTENSITY 5 CDIM) 

*PLOT A 

5PL0T SUBPICTURE 1 

*INTENSITY 13 CBRIGHT) 

JPLOT C 

*PLOT SUBPICTURE 2 

^TRANSFER TO LIST 1 

; INTENSITY 10 CNORMAL) 
*PLOT B 
*PLOT D 

;end of cokmand list 
* output data 
*pointed to by list 

jY= 6* X=6 

iY= 70* X=105 

;Y= 105* X=70 

*Y=1000* X=200 

ISUBPICTURE 1 
J SUBPICTURE 2 
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OUTPUT 


D^ LIST 


LIST: 


lOWD 


1 :.A 




10 WD 


S^SUBPl 




10 WD 


1 ^C 




lOWD 


5^ SUBP 1 




lOWD 


I jB 




lOWD 


2*SUBP2 




lOWD 


0^LIST1 


LISTl : 


lOWD 


1 ^D 




10 WD 


S^SUBPl 




lOWD 


1 ^A 




lOWD 


2^SUBP2 




XWD 


0^0 


A 




X = 6 


Y = 6 


B 




X = 105 


Y = 70 


C 




X=70 


Y=105 


D: 


X=1000 


Y=-200 


SUBP 1 : 


BLOCK 


5 


SL 


IBP2: 


BLOCK 


2 



^OUTPUT DATA POINTED 
STO BY POINTER IN LIST 

^•SET STARTING POINT TO (6^6) 

>DRAW A CIRCLE 

iSET STARTING POINT TO (70,105) 

^DRAW A CIRCLE 

iSET STARTING POINT TO (10 5,70) 

iDRAW A TRIANGLE 

^TRANSFER TO LISTl 

^SET STARTING POINT TO 

i ( 100, -200) 

iDRAW A CIRCLE 

iSET STARTING POINT TO (6,6) 

iDRAW A TRIANGLE 

J STOP 



iDRAW A CIRCLE 
,-DRAW A TRIANGLE 



The example shows the flexibility of this format. The user can display a subpicture by setting up a 
pomter. He can also display the same subpicture in many different places by setting up pointers to 
the subpicture, each preceded by a pointer to commands for the display to reset its coordinates. 



5.3.4 File Status (See Appendix D) 

The file status of the display is shown below. 

Standard Bits 



'8 21 24 27 30 



SET BY USER 



SFT BY MONITOR 



23 



33 35 









Bit23-IO.ACT Device is active. 

^Q g< 24 27 30 33 35 



UNUSED 



Device Dependent Bits - None. 



CZZ] 
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5.4 LINE PRINTER 

The device mnemonic Is LPT; the buffer size is 37g (36g data) words. 

5.4.1 Data Modes 

5 4 11 ASai, Octal Code - ASQl characters are transmitted to the line printer exactly as they 

appear in the buffer. Refer to the PI^P-10 System Reference Manual for a list of the vertical spacing 

characters. 

5 4 12 ASCII Line, Octal Code 1 - This mode is exactly the same as ASCII and is included for pro- 
gramming convenience. All format control must be performed by the user's program; this includes 
placing a RETURN, LINE-FEED sequence at the end of each line. 

5.4.1 .3 Image, Octal Code 10 - This mode is the same as ASCII mode. 

5.4.2 Special Programmed Operator Service 

J I ^c « fsia nnA thfi CLOSE at the end of a file cause an extra form- 

The first output programmed operator of a file and the ^-LUic 

feed to be printed to keep files separated. 

After each interrupt, the line pri tores the results of a CONI in the DEV5TS word of the device 

data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.10.1). 

5.4.3 File Status (See Appendix D) 

The file status of the line printer is shown below. 

Standard Bits 



SET BY USER 

Bit 29 -I0.5FF 



18 21 24 27 29 30 33 35 

I 



Suppress FORM FEEDS on an OPEN or RELEASE 



23 



SET BY MONITOR 



ill I I I I 



Bit 23- lO. ACT 



Device is active. 



Device dependent bits - None. 
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5.5 MAGNETIC TAPE 

Magnetic tape format is industry compatible, 7- or 9-channel 200, 556, and 800 bits/in. (see 

description below). The device mnemonic is MTAO, MTAl , . . . , MTA7; the buffer size is 203g (200g 

data) words. The user may change the density and/or the blocksize of a magnetic tape by using the 

SET DENSITY and SET BLOCKSIZE monitor commands (refer to the DECsystem-10 Operating System 

Commands). 

5.5.1 Data Modes 

5.5.1 .1 ASCII, Octal Code - Data appears to be written on magnetic tape exactly as it appears in 
the buffer. No processing or checksumming of any kind is performed by the service routine. The parity 
checking of the magnetic tape system is sufficient assurance that the data is correct. Normally, all 
data, both binary and ASCII, is written with odd parity and at 800 bits per inch unless changed by the 
installation. A maximum of 200g words per record is allowed if the monitor has set up the buffer ring. 
If the user builds his own buffers, he may specify any number of words per record. The word count is 
not written on the tape. If an I/O error occurs or an end-of-tape is reached, reading ahead ceasing 
on input and implied output ceases on output. 

5.5.1 .2 ASCII Line, Octal Code 1 - The mode is the same as ASCII. 

5.5.1 .3 Image, Octal Code 10 - The mode is the same as ASCII, but data consists of 36-bit words. 

5.5.1 .4 Image Binary, Octal Code 13 - The mode is the same as Image. 

5.5.1.5 Binary, Octal Code 14 - The mode is the same as Image. 

5.5.1.6 DR (Dump Records), Octal Code 16 - Standard fixed length records (128 words is the standard 
unless installation standard is changed at MONGEN time) are read into or written from anywhere in 
the user's core area without regard to the standard buffering scheme. Control for read or write opera- 
tions must be via a command list in core memory. The command list format is described in Chapter 4. 
For input operations a new record is read for each word in the command list (except GOTO words); if 
the record terminates before the command word is satisfied, the service routine reads the next records. 
If the command word runs out before the record terminates, the remainder of the record is ignored. 

For each output command word, enough standard length records are followed by one short record to 
exactly write all of the words on the tape. If an I/O error occurs or the end-of-tape is reached, no 
additional commands are retrieved from a dump mode command list, and I/O is terminated. When the 
end of file is read, the user receives the standard EOF return (the error return from the INPUT or 
IN UUO)and the lO.EOF bit is set in the file status word. This bit can be retrieved with the GETSTS 
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UUO. The EOF character (17^ for 7-channel tapes or 23g for 9-channel tapes) is read Into the user's 
buffer. The next INPUT or IN UUO will read the next record on the tape. 

5.5.1 .7 D (Dump), Octal Code 17 - Variable length records are read into or written from anywhere 
in the user's core area without regard to the standard buffering scheme. Control for read or write oper- 
ations must be via a command list in core memory. The command list format is described in Chapter 4. 
For input operations a new record is read for each word in the command list (except GOTO words); if 
the record terminates before the command word is satisfied, the service routine skips to the next com- 
mand word. If the command word runs out before the record terminates, the remainder of the record 
is ignored. For each output command word, exactly one record is written. Refer to Paragraph 5.5. 1 .6 
for the description of EOF handling in dump mode. 

5„5.2 Magnetic Tape Fonnat 

Magnetic tape format can generally be described as unlabelled, industry -compatible format. That is, 
as far as the user is concerned, the tape contains only data records and EOF marks, which signal the 
end of the data set or the end of the file. 

An EOF mark consists of a record containing a 17g (for 7-channel tapes) or a 23^ (for 9-channel tapes). 
EOF marks are used in the following manner: 

a. No EOF mark precedes the first file on a magnetic tape. 

b. An EOF mark follov/s every file. 

c. Two EOF marks follow a file if that file is the last or only file on the tape. 

Files are sequentially written on and read from a magnetic tape. A file consists of an integral number 
of physical records, separated from each other by interrecord gaps (area on tape in which no data is 
written). There may or may not be more than one logical record in each physical record. 

5.5.3 Special Programmed Operator Service 

CLOSE performs a special function for magnetic tape. When an output file is closed (both dump and 
nondump), the I/O service routine automatically writes two EOF marks and backspaces over one of 
them. If another file is opened, the second EOF mark is wiped out leaving one EOF mark between 
files. At the end of the in-use portion of the tape, however, a double EOF character, which is de- 
fined as the logical end of tape, appears. 



After each interrupt, the magnetic tape service routine stores the results of a CONI in the DEVSTS 
word. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4.10.1). 
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5.5.3. 1 MTAPE UUO - The MTAPE programmed operafor provides for tape manipulation funcHons 
such as rewind, backspace record, backspace file, and 9-channel tape initialization. The format is 

MTAPE D, FUNCTION 

where D is the device channel on which the magnetic tape unit is initialized. FUNCTION is selected 
according to Table 5-2. 



Table 5-2 
MTAPE Functions 



Symbol 



Function 



Acti 



MTWAT. 





MTREW. 


1 


MTEOF. 


3 


MTSKR. 


6 


MTBSR. 


7 


MTEOT. 


10 


MTUNL. 


n 


MTBLK. 


13 


MTSKF. 


16 



MTBSF. 

MTDEC. 
MTIND. 



17 

100 
101 



No operation; wait for spacing and I/O to finish. 

Rewind to load point. 

Write EOF. 

Skip one record. 

Backspace record . 

Space to logical end of tape; terminates at either two 
consecutive EOF marks or at the end of first record 
beyond end of tape marker . 

Rewind and unload. 

Write 3 in. of blank tape. 

Skip one file; implemented by a series of skip recwd 
operations. 

Backspace files; implemented by a series of backspace 
record operations. 



Initialize for Digital -compatible 9-channel. 



t 



tt 
Initialize for industry-compatible 9-channel tape. 



tt 



Digital-compatible mode writes (or reads) 36 data bits in five frames of a 9-track 
magnetic tape. It can be any density, any parity, and is not industry compatible. 
This mode is in effect until a RELEAS D, or a MTIND. D, is executed. 

Industry-compatible 9-channel mode writes (or reads) 32 data bits per word in four 
frames of a 9-track magtape and ignores the low order four bits of a word. It must 
be 800 bits/in. density, odd parity. 



MTAPE waits for the magnetic tape unit to complete the action in progress before performing the in- 
dicated function, including no operation (0). Bits 18 through 25 of the status word are then cleared, 
the indicated function is initiated, and control is immediately returned to the user's program. It is 
important to remember that when performing buffered input/output, the I/O service routine can be 
reading several blocks ahead of the user's program. MTAPE affects only the physical position of the 
tape and does not change the data that has already been read into the buffers. Therefore, an INPUT 
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or OUTPUT following a MTAPE may not retrieve the buffer containing the block requested. However, 
a single buffer ring retrieves the expected block since the device must stop after each INPUT or 
OUTPUT. Alternatively, if bit 30 0O.SYN) of the file status word is set via the INIT or SETSTS UUO, 
the device stops after each buffer is filled on an INPUT or OUTPUT. Thus, the MTAPE will apply to 
the buffer supplied on the next INPUT or OUTPUT. 

MTAPE functions must be followed by MTAPE if subsequent operations depend on the completion of 
the MTAPE function. If this is not done, subsequent input and output UUOs are ignored until the 
magnetic tape control is freed. This problem occurs frequently in programs that issue a REWIND at 
the beginning of the program. The tape may actually be positioned at the beginning of the tape; 
however, the processing of the MTAPE function may cause the first input to be ignored. 

Issuing a backspace file command to a magnetic tape unit moves the tape in the reverse direction until 
the tape has: 

a. passed the end of file mark 

b. reached the beginning of the tape. 

The end of the backspace file operotion positions the tape heads either immediately in front of a file 
mark or at the beginning of the tape. 

In most cases it is desirable to skip forward over this file mark. This is decidedly not the case if the 
beginning of the tape is reached; in this case, giving a skip file command would skip the entire first 
file on the tape stopping at the beginning of the second file, rather than leaving the tape positioned 
at the beginning of the first file. Therefore, a typical (incorrect) sequence for backspace file would 
be: 



MTBSF. MT* 
WAIT MT* 
STATO MT*4000 
MTSKF. MT# 



Backspace file 
Wait tor completion 
Beginning of tape? 
No, skip over file mark 



It is necessary to wait after the backspace file instruction to ensure that the tape is moved to the EOF 
mark or the beginning of the tape before testing to see whether or not it is the beginning of the tq>e. 
The instruction WAIT MT, cannot be used for this purpose; it waits only for the completion of I/O 
transfer operation. (Backspace file is a spacing operation, not an I/O transfer operation.) Instead, 
use the following sequence for backspace file: 

KTAPE MT^-l? /Backspace file 

KTAPE MT*0 ;Wait tor completion 

STATO MT*4000 ; Beg inning of tope? 

MTAPE MT#16 ;No, skip over file mark 



5.04 Monitor 5-14 January 1972 



-507- PIONITOR CALLS 

The device service routine must wait until the magnetic tape control is free before processing the 
MTAPE MT, command, which tells the tape control to do nothing. Thus, the service routine achieves 
the waiting period necessary for the completion of the previous operation and the proper positioning of 
the tape. 

5.5.3.2 MTCHR. AC, or CALLI AC, 112^ - This UUO returns the characteristics (presently only 
the density is returned) of the specified magnetic tape drive. The density of the drive can be speci- 
fied by setting bits 27 and 28 in the status word when the drive is INITed and can be changed with 
the SET DENSITY command. The call Is: 

MOVE AC, ESIXBIT/dev/l ;or MOVEI AC, channel number 

MTCHR. AC, ;or CALLI AC, 112 
error return ,/ 

normal return 

In determining the density to return, the monitor examines the initial file status specified with the 
INIT UUO and returns the indicated density value. If this value is zero, the monitor then determines 
if the user specified a density with the SET DENSITY system command. If no density has been speci- 
fied in this way, the monitor returns the system default density. 

The MTCHR. UUO is used to obtain more complete information than that returned with the GETSTS 
UUO. The GETSTS UUO returns only the density specified in the INIT UUO and if the density is 
specified as zero (for the system default), zero is returned, not the actual system default. The den- 
sity specified in the SET DENSITY command cannot be returned with the GETSTS UUO. 
The error return is given if the UUO is not implemented (AC remains unchanged) or if there is no de- 
vice on the specified channel or if the device is not a magnetic tape (AC contains -1). 

On a normal return, bits 34 and 35 of AC contain the current density of the magnetic tape drive: 



AC contains 1 


200 bpi 


AC contains 2 


556 bpi 


AC contains 3 


800 bpi 



5.5.4 9-Channel Magtape 

Nine-channel magtape may be written and read in two ways: normal Digital -compatible format and 
industry-compatible format. 



This UUO depends on FT5UUO which is normally off in the DECsystem-1040. 
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5o5,4ol Digltal-Compafible Mode - Digital-compatible mode, the usual mode, allows old 7-channel 
user mode programs to read and write 9-channel tapes with no modification. Digital-compatible mode 
writes 36 data bits in five bytes of a nine track magtape. It can be any density, and parity, and is not 
industry compatible. The software mode is specified in the usual manner during initialization or with 
a SETSTS. User mode I/O is handled precisely as 7-track magtape. It is assumed that most DEC 
magtapes will be written and read in Digital-compatible mode. 

For the data word in core there are 5 magnetic tape bytes per 36-bit word. Parity bits are unavailable 
to the user. Bits are written on tape as shown above; bits 30 and 31 are written twice and tracks 8 and 
9 of byte 5 contain 0. On reading, parity bits and tracks 8 and 9 of byte 5 are ignored, the OR of 
bits (B30) is read into bit 30 of the data word, the OR of bits (B31) is read into bit 31 . 

Data Word on Tape 



Tracks 


9 


8 


7 


6 


5 


4 


3 


2 


1 


BO 


Bl 


B2 


B3 


B4 


B5 


B6 


B7 


P 


B8 


B9 


BIO 


Bll 


B12 


B13 


B14 


B15 


P 


B16 


B17 


B18 


B19 


B20 


B21 


B22 


B23 


P 


B24 


B25 


B26 


B27 


B28 


B29 


(B30) 


(B31) 


P 


G 





(B30) 


(B31) 


B32 


B33 


B34 


B35 


P 


P = Parity 
















BN = Bit N in core. 

















5.5.4.2 Industry -Compatible Mode - For reading and writing industry -compatible 9-channel magtapes, 
an MTAPE D, 101 DUO must be executed to set the status. MTAPE D, 101 is meaningful for 9-channel 
magtape only and is ignored for all other devices. In the left half of the status word, bit 2 (which 
cannot be read by the user program) may be cleared, thus, the device is returned to 9-channel Digital- 
compatible status by a RELEAS, a call to EXIT, or an MTAPE D, 100 UUO. These MTAPE UUOs act 
only as a switch to and from industr/-compatible mode and affect l/O status only by setting the density 
to 800 bits/in. and odd parity. 

On INPUT, four 8-bit bytes are read into each word in the buffer, left justified, with the remaining 
four bits of the word containing character parity error indicators corresponding to the 8-bit bytes. 

On OUTPUT, the leftmost four 8-bit bytes of each word in the buffer are written out in four frames, 
with the remaining four rightmost bits of the word being ignored. 



5-16 



March 1973 



-509- 

Data Word on Tape 



MONITOR CALLS 



Tracks 


9 


8 


7 


6 


5 


4 


3 


2 


1 


BO 


B1 


B2 


B3 


B4 


B5 


B6 


B7 


B32 


B8 


B9 


BIO 


B11 


B12 


B13 


B14 


B15 


B33 


816 


B17 


BIB 


B19 


B20 


B21 


B22 


B23 


B34 


B24 


B25 


B26 


B27 


B28 


B29 


B30 


B31 


B35 



For data word in core, four magnetic tape bytes carry four 8-bit bytes from the data word. Parity bits 
are obtained as shown above when reading. The rightmost four bits (32-35) are ignored on writing. 

5.5.4.3 Changing Modes - MTAPE CH, 101 automatically sets density at 800 bits (i.e., 800 eight- 
bit bytes) per inch and sets odd parity. Note that buffer headers are set up, when necessary by the 
monitor in the usual manner according to the I/O mode in which the device is initialized. In order to 
operate on eight-bit bytes, the user must insert the byte size in the byte pointer before the first IN or 
OUT. 
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5.5.5 File Sfal-us (refer to Appendix D) 

The file status of the magnetic tape is shown below. 

Standard Bits 
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18 21 24 27 30 33 35 



SET BY USER 








1 


1 
SET BY MONITOR 


8 


21 24 















Bit 18 -lO.IMP 

Bit 19 -lO.DER 
Bit 20 -lO.DTE 
Bit 21 -lO.BKT 
Bit 22 -lO.EOF 

Bit 23 -lO.ACT 



Unit was write-locked when output was attempted, 
or illegal operation was specified to the magnetic- 
tape control . 

Data was missed, tape is bad, or transport is hung. 

Parity error. 

Record read from tape exceeds buffer size. 

EOF mark encountered. A 17^ (for 7-channel tapes) or a 
23 (for 9-channel tapes) appears in buffer. 

Device is active. 



Device Dependent Bits 



18 21 24 26 27 30 33 35 



SET BY USER 



I 



Bit 26 -lO. PAR I/O parity. for odd parity, 1 for even parity. Odd 

parity is preferred. Even parity should be used only 
when creating a tape to be read in binary coded deci- 
mal (BCD) on another computer. 

Bit 27-28 - lO.DEN I/O density. 00 = System standard. Defined at 

MONGEN time and can be changed 
with the SET DENSITY command. 
01 = 200 bits/in. 

10 = 556 bits/in. 

11 - 800 bits/in. 



Bit 29 -lO.NRC 



I/O no read check. Suppress automatic error correction 
if bit 29 is 1. Normal error correction repeats the de- 
sired operation 10 times before setting an error status bit. 
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18 21 24 25 27 30 33 35 

SET BY MONITOR 



10-0558 



Bit 24 - lO.BOT I/O beginning of tape. Unit is at beginning of tape mark. 

Bit 25 - lO.EOT I/O tape end. Physical end of tape mark encountered. 

5.6 PAPER-TAPE PUNCH 

The device mnemonic is PTP; the buffer size is 43g (40g data) words. 

5.6.1 Data Modes 

5.6.1 . 1 ASCII, Octal Code - The eighth hole is punched when necessary in order to make even 
parity. Tape-feed without the eighth hole (000) is inserted after form-feed. A rubout is inserted 
after each vertical or horizontal tab. Null characters (000) appearing in the buffer are not punched. 

5.6.1 .2 ASCII Line, Octal Code 1 - The mode is the same as ASCII mode. Format control must be 
performed by the user's program. 

5.6.1 .3 Image, Octal Code 10 - Eight-bit characters are punched exactly as they appear in the 
buffer with no additional processing. 

5.6.1 .4 Image Binary, Octal Code 13 - Binary words taken from the output buffer are split into six 
6-bit bytes and punched with the eighth hole punched in each line. There is no format control or 
checksumming performed by the I/O routine. Data punched in this mode is read back by the paper- 
tape reader in the IB mode. 

5.6. 1 .5 Binary, Octal Code 14 - Each bufferful of data is punched as one checksummed binary block 
as described for the paper-tape reader. Several blank lines are punched after each bufferful for visual 
clarity. 

5.6.2 Special Programmed Operator Service 

The first output programmed operator of a file causes approximately two fanfolds of blank tape to be 
punched as leader. Following a CLOSE, an additional fanfold of blank tape is punched as trailer. No 
EOF character is punched automatically. 

After each interrupt, the paper-tape punch stores the results of a CONI in the DEVSTS word of the 
device data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user 
(refer to Paragraph 4. 10. 1). 
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5.6.3 File Status (Refer to Appendix D) 

The file status for the paper-tape punch is shown below. 

Stancktrd Bits 
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18 21 24 27 30 33 35 



SET BY USER 








::^i 1 




23 


SET BY MONITOR 






1 









Bit 23 -lO.AGT 



Device is active. 



UNUSED 






Device Dependent Bits - None. 



5.7 PAPER-TAPE READER 



The device mnemonic is PTR; the buffer size is 43q (40o data) words. 

o o 



5.7.1 Data Modes (Input Only) 



NOTE 



To initialize the paper-tape reader, the input tape must 
be threaded through the reading mechanism and the FEED 
button must be depressed. 



5.7.1.1 ASCII, Octal Code - Blank tape (000), RUBOUT (377), and null characters (200) are 
ignored. All other characters are truncated to seven bits and appear in the buffer. The physical end 
of the paper tape serves as an EOF, but does not cause a character to appear in the buffer. 

5.7.1 .2 ASCII Line, Octal Code 1 - Character processing is the same as for ASCII mode. The buffer 
is terminated by LINE FEED, FORM, or VT. 

5.7.1 .3 Image, Octal Code 10 - There is no character processing. The buffer is packed with 8-bit 
characters exactly as read from the input tape. Physical end of tape is the EOF indication but does 
not cause a character to appear in the buffer. 
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5.7.1.4 Image Binary, Octal Code 13 - Characters not having the eighth hole punched are ignored. 
Characters are truncated to six bits and packed six to the word without further processing. This mode 
is useful far reading binary tapes having arbitrary blocking format. 

5.7.1 .5 Binary, Octal Code 14 - Checksummed binary data is read in the following format. The 
right half of the first word of each physical block contains the number of data words that follow and 
the left contains half a folded checksum. The checksum is formed by adding the data words using 2's 
complement arithmetic, then splitting the sum into three 12-bit bytes and adding these using 1 's com- 
plement arithmetic to form a 12-bit checksum. The data error status flag (refer to Table 4-3 in 
Paragraph 4.6.2) is raised if the checksum miscompares. Because the checksum and word count appear 
in the input buffer, the maximum block length is 40. The byte pointer, however, is initialized so as 
not to pick up the word count and checksum word. 

Again, physical end of tape is the EOF indication, but does not result in putting a character in the 
buffer. 

5.7.2 Special Programmed Operator Service 

After each interrupt, the paper-tape reader stores the results of a CONI in the DEVSTS word of the 
device data block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user 
(refer to Paragraph 4. 10. 1). 

5.7.3 File Status (Refer to Appendix D) 

The file status of the paper-tape reader is shown below. 
Standard Bits 



18 


21 


24 


27 


30 


33 3! 


SET BY USER 








1 i 


1 
SET BY MONITOR 


8 


20 22 


23 










II 













Bit 18 -lO.IMP 
Bit 20-IO.DTE 
Bit 22 -lO.EOF 

Bit 23 - lO.ACT 



Binary block is incomplete. 

Bad checksum in binary mode. 

Physical end of tape is encountered. No character 
is stored in the buffer. 

Device is active. 
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1819 21 



UNUSED 



Device dependent bits - None 



5.8 PLOTTER 



The device mnemonic is PLT; the buffer size is 43 (40. data) words. The plotter takes 6-bit characters 
with the bits of each character decoded as follows: 



PEN 
RAISE 


PEN 
LOWER 


-X 

DRUM 

UP 


+ X 
DRUM 
DOWN 


+Y 

CARRIAGE 

LEFT 


-Y 

CARRIAGE 

RIGHT 



Do not combine PEN RAISE or LOWER with any of the position functions. (For more details on the 
incremental plotter, refer to the PDP-10 System Reference Manual.) 

5.8.1 Data Modes 

5.8.1 .1 ASCII, Octal Code - Five 7-bit characters per word are transmitted to the plotter exactly 
as they appear in the buffer. The plotter is a 6-bit device; therefore, the leftmost bit of each charac- 
ter is ignored. 

5.8.1 .2 ASCII Line, Octal Code 1 - This mode is identical to ASCII mode. 

5.8.1 .3 IMAGE, Octal Code 10 - Six 6-bit characters per word are transmitted to the plotter ex- 
actly as they appear in the buffer. 

5.8.1 .4 IMAGE BINARY, Octal Code 13 - This mode is identical to Image mode. 

5.8.1 .5 BINARY, Octal Code 14 - This mode is identical to Image mode. 

5.8.2 Special Programmed Operator Service 

The first OUTPUT operator causes the plotter pen to be lifted from the paper before any user data is 
sent to the plotter. The CLOSE operator causes the plotter pen to be lifted after all user data is sent 
to the plotter. These two pen-up commands are the only modifications the monitor makes to the user 
output file. 
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After each inferrupt, the plotter stores the results of a CONI in the DEVSTS word of the device data 
block. The DEVSTS UUO is used to return the contents of the DEVSTS word to the user (refer to 
Paragraph 4. 10. 1). 

5.8.3 File Status (Refer to Appendix D) 
The file status of the plotter is shown below. 
Standard bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 



23 



Bit 23 - lO.ACT Device is active. 



UNUSED 



Device dependent bits - None 



5.9 PSEUDO-TTY 



The device mnemonic is PTYO, PTYI, ..., PTYn. (The number of pseudo-TTYs is specified at 

MONGEN time.) The buffer size is 23_ (20. data) words. 

o o 

5.9.1 Concepts 

Each Job in the DECsystem-10 is usually initiated by a user at a physical terminal. Except in the 
case of a DETACH operation, the job remains under the control of the user's terminal until it is ter- 
minated by either the KJOB command or the LOGOUT UUO. For each physical terminal there is a 
block of core in the monitor, containing information about the physical terminal and including two 
buffers as the link between the physical terminal and the job. It is through these buffers that the 
terminal sends input to the job, and the job returns output to the terminal. 



5.06 Monitor 
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SomeHmes it Is desirable to allow a job in the DECsystem-10 to be initiated by a program instead of 
by a user. Since a program cannot use a physical terminal in the way a user can, some means must be 
provided in the monitor for the program to send input to and accept output from the job it is controlling. 
The monitor provides this capability via the pseudo-TTY (PTY). The PTY is a simulated terminal and is 
not defined by hardware. Like hardware -defined terminals, each PTY has a block of core associated 
with it. This block of core is used by the PTY in the same manner as a hardware-defined terminal uses 
its block of core. Figure 5-1 shows the parallel between a hardware-defined terminal and a software- 
defined PTY. 



USER 



PHYSICAL 
TERMINAL 



*• h 



DEVICE TTY, 

OR 
DEVICE TTYn 



I 



L 



J 



CONTROLLED 
JOB 





r 






mUNl 1 UK 


1 


CONTROLLING ^ 


1 


DEVICE PTY 




DEVICE TTY, 

OR 
DEVICE TTYm 


1 


PROGRAM **" 


1' 




■ I' 



CONTROLLED 
JOB 



Figure 5-1 Pseudo-TTY 

The controlling program, most commonly the batch processor, uses the PTY in the same way a user uses 
a physical device. It initiates the PTY, inputs characters to and waits for output from the PTY, and 
closes the PTY using the appropriate programmed operators. The }ob controlled by the program per- 
forms I/O to the PTY as though the PTY were a physical terminal. 

A controlled job may go into a loop and not accept any input from its associated buffer; therefore, it 
is not possible for the controlling program to simply rely on waiting for activity in the controlled job. 
A controlling program may also wish to drive more than one controlled job, and be able to respond to 
any of these jobs; therefore, the controlling program cannot wait for any particular PTY. For these 
two reasons, the PTY differs from other devices in that it is never in a I/O wait state. Timing is ac- 
complished by the HIBER UUO and the status bits of the PTY. 

5.9.2 The HIBER UUO 

The HIBER UUO (refer to Paragraph 3.1.4.2) allows the controlling program to temporarily suspend its 
operation until either there is activity in the controlled job or the specified amount of sleep time runs 
out, whichever occurs first. If bit 12 in the AC is set in the HIBER UUO call, any PTY activity since 
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the last HIBER UUO causes the controlling program to be awakened. If no PTY activity occurs before 
the limit of sleep time is reached, the controlling program is activated, and it checks the controlled 
job's run time or other criteria to determine whether the job should be interrupted. If the job should 
be interrupted, the controlling program may output two control-C characters to stop the job. (A 
timesharing user stops a running job in the same way.) If the job should not be interrupted, the con- 
trolling program should repeat the HIBER UUO. 

If bit 12 in AC is not set, unnecessary delays might result if activity occurred on a PTY while the 
controlling job was sleeping. To avoid these delays, a check is made when a PTY status bit changes 
to determine if the controlling program is in a sleep. If it is, the sleep time is cleared so the con- 
trolling program can service the PTY. 

5.9.3 File Status (Refer to Appendix D) 

The file status of the pseudo-TTY is shown below. 

Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 



21 23 



Bit 21 -lO.BKT 

Bit 23 - lO.ACT Device is active. 



Device Dependent Bits 



18 21 24 27 30 33 35 



SET BY MONITOR 



Bit 24-IO.PTI 
Bit 25 -lO.PTO 
Bit 26 -lO.PTM 



Job is in a TTY input wait. The controlling job 
should perform an OUTPUT to the PTY. 

The TTY buffer has output to be read by an 
INPUT from the PTY. 

Any characters typed into the TTY buffer (by 
OUTPUT to the PTY) are read by the monitor 
command decoder instead of by the controlled 
fob (i.e. , the controlled job is in monitor mode), 
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5.9.4 Special Programmed Operator Service 

5.9.4.1 OUT, OUTPUT UUOs - The first OUTPUT operation after an INIT or OPEN causes the 
special actions of the RELEASE UUO (refer to Paragraph 5.9.4.3) and then the following normal out- 
put operations. 

a. Characters from the controlling program's buffer ring are placed in the input buffer 
of the TTY linked to the PTY. 

b. The lO.PTI bit is cleared. 

c. The lO.PTM bit is set or cleared as determined by the state of the TTY. 

The following are exceptions to the normal output action: 

a. NULLS (ASCII 000) are discarded. 

b. If more OUTPUTS are performed than are accepted by the controlled job and if the limit 
on this excess is exceeded, the lO.BKT bit is set and the remainder of the controlling 
program's buffer is discarded. 

c. Lower case characters sent to the controlled |ob are translated to upper case if the ap- 
propriate bit in the TTY is set, 

5.9.4.2 IN, INPUT UUOs - Characters are read from the output buffer of the TTY and are placed 
in the buffer ring of the contColling program. If there are no characters to read, an empty buffer is 
returned. The INPUT UUO does not cause a WAIT. 

All the available characters are passed to the controlling program. If there are more characters to 
read than can fit in the buffer of the controlling program, the lO.PTO bit remains set and another 
INPUT should be done. If the output buffer of the TTY is exhausted by the INPUT UUO, the lO.PTO 
bit is cleared. 

5.9.4.3 RELEASE UUO - The RELEASE UUO causes the following special actions: 

a. Any characters in the output buffer of TTY are discarded. 

b. If the controlled job is still attached to TTY, it is detached. 

c. The PTY is disassociated from the software channel. 

CAUTION 

Haphazard use of the PTY and subsequent RELEASE opera- 
tions may leave detached jobs tying up core and other sys- 
tem resources. 

5.9.4.4 JOBSTS UUO - This UUO provides status information about devices TTY and/or the con- 
trolled job in order to allow complete and accurate checking of a controlled job. 
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The cqll is: 

MOVEI AC, user channel number ;or MOVNI AC, job number 

JOBSTS AC, ;or CALLI AC, 61 

error return 
normal return 

When the UUO is called, AC contains a number n specifying the [ob and/or the TTY to be checked. 
If n is from to 17, the specified TTY and job are those currently INITed on the user's channel n. 
If n is negative, the job to be checked is job number (-n). 

The error return is given if one of the following is true: 

a. the UUO is not implemented. If this is the case, check the l/O status word. 

b. n is out of range. 

c. there is no PTY INITed on channel n. 

Otherwise the normal return is given and AC contains the following status information: 



Explanation 



Name Bit 

JB.UJA Bit = 1 Job number is assigned. 

JB.ULI Bit 1 = 1 Job is logged in. 

JB.UML Bit 2 = 1 TTY is at monitor level. 

JB.UOA Bit 3 = 1 TTY output is available. 

JB.UDI Bit 4 = 1 TTY is at user level and in input wait, or TTY is at monitor 

level and can accept a command. In other words, there is 
no command awaiting decoding or being delayed, the job is 
not running, and the job is not stopped waiting for operator 
device action. 

JB.UJC Bit 5=1 JACCTisset. In particular, tCtC will not work. 

Bits 6-17 Reserved for the future. 

JB.UJN Bits 18-35 Job number being checked or if no job number is assigned. 

5.9.4.5 CTLJOB UUO - This UUO is used to determine the job number of the program (job) that is 
controlling the specified job, if any. 



The call is: 



MOVE AC, job number ;-l means user's job 

CTLJOB AC, ;or CALLI AC, 65 



error return 
normal return 
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On a normal return, AC contains the job number of the program (job) that is controlling the controlled 
job. If AC = -1 , the specified job is not being controlled via a PTY. 

An error return is given if the UUO is not implemented or the job number is too large. 

5.10 TERMINALS 

The device mnemonic is TTYO, TTYl, . , . , TTY176, TTY177, CTY; the buffer size is 23g (20g data) 

words . 

Line number n of the Data Line Scanner DCIO, PDP-8 680 System, or PDP-8/1 DC68A System is refer- 
red to as TTYn. The console terminal is CTY. the DECsystem-10 monitor automatically gives the 
logical name TTY to the user's terminal when a job is initialized. 

Terminal device names are assigned dynamically. For interconsole communication by program, one 
of the two users must type DEASSIGN TTY to make the terminal available to the other user's program 
as an l/O device. Typing ASSIGN TTYn is the only way to reassign a terminal that has been de- 
assigned. 

In a full-duplex terminal service, the two functions of a console, typein and typeout, are handled 
independently, and do not need to be handled in the strict sense of output first and then input. For 
example: if two operations are desired from PIP, the request for the second operation can be typed 
before receiving the asterisk after completion of the first. To stop unwanted output, a Control O is 
typed. Also, the command Control C does not stop a program instantly; the Control C will be delayed 
until the program requests input from the keyboard, and then the program will be popped. When a 
program must be stopped instantly, as when it gets into a loop. Control C typed twice stops the pro- 
gram. 

If, during output operations on a half-duplex tenninal (not a local copy terminal), an echo-check 
failure occurs (i.e. , the received character was not the same as the transmitted character), the I/O 
routine suspends output until the user types the next character. If that character is tC, the temiinal 
is immediately placed in monitor mode. If it is tO, all TTY output buffers that are currently full are 
ignored, thus cutting the output short. All other characters cause the service routine to continue 
output. The user may cause a deliberate echo check by typing in while typeout is in progress. For 
example, to return to monitor control mode while typeout is in progress, the user must type any char- 
acter ("X", for example) until an echo check occurs and output is suspended; then he types tC. 

Programs waiting for TTY output are awakened ten characters before the output buffer is empty, causing 
them to be swapped in sooner and preventing pauses in typing. Programs waiting for TTY input will be 
awakened ten characters before the input buffer is filled, thus reducing the possibility of lost typein. 
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5.10.1.1 
characters 
program as 

000 
001 
002 
003 



ASCII, Octal Code and ASCII Line, Octal Code 1 - The input handling of all control 
is as follows. Characters with ASCII codes of 000 to 037 echo as tx and are passed to the 
a control character unless noted otherwise. 



NULL 
tA 
IB 
tC 



004 


\D 


(EOT) 


005 


IE 


(WRU) 


006 


tF 




007 


tG 


(Bell) 


010 


tH 


(Backspace) 


Oil 


tl 


(TAB) 


012 


tj 


(Linefeed) 


013 


tK 


(Vertical tab) 


014 


tL 


(Form) 


015 


tM 


(Carriage 
return) 


016 


tN 




017 


to 





020 


tP 




021 


to 


(XON) 


022 


tR 


(TAPE) 


023 


ts 


(XOFF) 



Ignored on input; suppressed on output. 

No special action. 

No special action. 

Not passed to program. The user's terminal is switched to 
monitor mode the next time input is requested by the program. 
Two successive tCs cause the terminal to be immediately 
switched to monitor mode. Performs a tU and a tO. For 
user program control of tC, refer to Paragraph 3.1.3.2. 

Not echoed; therefore typing in a control -D (EOT) does not 
cause a full-duplex data phone to hang up. 

No special action. 

No special action. 

Echoes as Bell and is a break character. 

Echoes OS backspace . 

Echoes as a TAB or an equivalent number of spaces. Refer 
to the SET TTY TAB command. 

Echoes as a linefeed and is a break character. 

Echoes as a vertical tab <yr 4 linefeeds. Refer to the SET 
TTY FORM command. 

Echoes as a FORMFEED or 8 linefeeds. Refer to the SET 
TTY FORM command . 

Passed to program if terminal is in a paper-tape input mode; 
otherwise, supplies a linefeed echo, is passed to program as 
a CR and LF, and is a break character due to the LF. 

No special action. 

Not passed to program. Complements output suppression bit 
allowing users to turn output on or off. INPUT, INIT, and 
OPEN clear the output suppression bit. This bit is also 
cleared by any other INPUT-class operation, such as DDTIN 
and TTCALLS 0, 2, 4, and 5, by input test TTCALLS 13 and 
14, and by returning to monitor command level via tC or 
EXIT operations. Echoed as tO followed by carriage return/ 
linefeed. 

No special action. 

Starts paper-tape mode if .TTY TAPE command has been 
given; refer to Paragraphs 5.10.8 and 5.10.9. 

No special action. 

Ends paper-tape mode; refer to Paragraphs 5. 10.8 and 5. 10.9. 
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026 


tv 


027 


tw 


030 


tx 


031 


tY 


032 


tz 


033 


tr 


034 


t\ 


035 


t] 


036 


ft 


037 


t*- 


040-137 




140-174 




175 and 17^ 


> 
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024 tT (NO TAPE) No special action. 

025 tU Deletes input line back to last break character. Echoed 

as tU followed by a carriage return/linefeed; is a break 
character. Passed to program if full character-«et mode 
is true. 

No special action. 

No special action. ' 

No special action. 

No special action. 

Acts as EOF on TTY input. Echoes as tZ followed by car- 
riage return/linefeed. Is a break character. 

(ESC) The standard ASCII escape. Echoed as $; is a break character. 

No special action. 

No special action. 

No special action. 

No special action. 

Printing characters, no special action. 

Lower case ASCII; translated to upper case, unless lower 
case mode is on. Echoes as upper case if translated to 
upper case . 

Old versions of altmode; converted to the standard 
escape (033) unless in full character set mode I NIT 
or TRMOP. DUO) or no ALTmode conversion is speci- 
fied (TRMOP. UUO or SET TTY NO ALT command). 

177 RUBOUT or DELETE: 

a. Completely ignored if in paper-tape mode (XON). 

b. Break character, passed to program if either DDT 
mode or full character-set mode is true. 

c. Otherwise (ordinary case) causes a character to be 
deleted for each rubout typed. All the characters 
deleted are echoed between a single pair of back- 
slashes. If no characters remain to be deleted, echoes 
as a carriage return/linefeed. 

On output, all characters are typed just as they appear in the output buffer with the exception of TAB, 
VT, and FORM, which are processed the same as on type-in. Programs should avoid sending tD, be- 
cause it may have catastrophic effects (e.g. , it may hang up certain data sets). 

5.10.1 .2 Image, Octal Code 10 - Image mode Is legal for TTY input and output, except fc»" terminals 
controlled by pseudo-TTYs (refer to Paragraph 5.9). Note that the terhiinal to be INITed in Image 
mode must be ASSIGNed to a job. An attempt to do input to an unassigned terminal receives an error 
return with the lO.IMP bit set in the file status word. Image mode is available only in the 5.02 
rrwnitor and later. 
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Because, on input, any sequence of input characters must be allowed, tC and tZ may not cause their 
usual escape functions. This means that if the user program accepts all characters and does not release 
the terminal from image mode, no typein will release the user from this state; consequently, the ter- 
minal would effectively become dead to the system. The break character cannot be used to escape 
from this situation, because DC 10 and the 630 do not detect the break character. To solve this de- 
sign problem, an image input state is defined. If during the image input state, no characters are re- 
ceived for 10 seconds the end-of-file is forced. After another 10 seconds, the image input state is 
terminated by SCNSER (scanner service) and a tC is simulated. Therefore, if the user discovers that 
his program has failed because of this condition, he simply stops typing until a tC appears. 

The image input state begins when the program goes into I/O wait because of an INPUT DUO in image 
I mode. It ends when the program executes any non-image terminal output operation. If no output is 
desired, the TTCALL UUO can be executed to output a null string. 

When using image mode input to read binary tapes, echoing should be suppressed by setting bit 28 in 
the TTY status word. 

NOTE 

Because there are no break characters in image mode, characters 
are transferred a character at a time instead of a line at a time. 
Therefore, an input buffer may only have one character in it 
when control is returned to the user program. 

On output, the low-order eight bits of each word in the user's buffer are output. These characters 
are transmitted exactly as supplied by the user. Parity is neither checked nor added, and filler char- 
acters are not generated. Image mode affects buffered output (INIT, OUTPUT UUOs) only, except 
for one TTCALL function (refer to Paragraph 5.10.3). 

I 5.10.2 DDT Submodel 

To allow a user's program using buffered I/O and the DDT debugging program to use the same terminal 
without interferring with one onofher, the TTY service routine provides the DDT submode. This mode 
does not affect the TTY status if it is initialized with the INIT operator. It is not necessary to use 
INIT to perform I/O in the DDT submode. I/O in DDT mode is always to the user's terminal and not 
to any other device. 

In the DDT submode, the user's program is responsible for its own buffering. Input is usually one 
character at a time, but if the typist types characters faster than they are processed, the TTY service 
routine supplies buffers full of characters at the same time. 



The usage described in this section is obsolete; new programs should use the TTCALL UUO 
(refer \o Paragraph 5. 10.3). 
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To input characters In DDT mode, use the sequence 

MOVEI AC^BUF 

CALL AC> CSIXBIT/DDTIM/3 

BUF Is the first address of a 21-word block in the user's area. The DDTIN operator delays, if necessary, 
until one character is typed in. Then all characters (in 7-bit packed format) typed in since the pre- 
vious occurrence of DDTIN are moved to the user's area in locations BUF, BUF+1. The character string 
is always terminated by a null character (000). RUBOUTs are not processed by the service routine but 
are passed on to the user. The special control characters tO and tU have no effect. Other characters 
are processed as in ASCII mode. 

To perform output in DDT mode, use the sequence 

MOVEI AC, BUF 

CALL ACCSIXBIT /DDTOUT/3 

BUF is the first address of a string of packed 7-bit characters terminated by a null (000) character. 
The TTY service routine delays until the previous DDT OUT operation is complete, then moves the 
entire character string into the monitor, begins outputting the string, and restarts the user's program. 
Character processing Is the same as for ASCII mode output. 

5.10.3 Special Programmed Operator Service 

The TTCALL UUO is used to extend the capabilities of the terminal. The TTCALL operations are per- 
formed for a physical terminal (not a logical name TTY) and most operations reference the terminal 
controlling the job which executed the UUO. (There are exceptions, such as in the case of GETLCH.) 

The general form of the TTCALL (operation code 051) programmed operator is as follows: 
TTCALL AC, ADR 

The AC field describes the particular function desired, and the argument (if any) is contained in ADR. 
ADR may be an AC or any address in the low segment above the job data area (137). It may be in 
high segment for AC fields 1 and 3. The functions are: 
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AC Field 


Mnemonic t 


Action 





INCHRW 


Input character and wait 


1 


OUTCHR 


Output a character 


2 


INCHRS 


Input character and skip 


3 


OUTSTR 


Output a string 


4 


INCHWL 


Input character, wait, line mode 


5 


INCHSL 


Input character, skip, line mode 


6 


GETLCH 


Get line characteristics 


7 


SETLCH 


Set line characteristics 


10 


RESCAN 


Reset input stream to commond 


11 


CLRBFI 


Clear type-in buffer 


12 


CLRBFO 


Clear type -out buffer 


13 


SKPINC 


Skip if a character can be input 


14 


SKPINL 


Skip if a line can be input 


15 


lONEOU 


Output as an image character 


16-17 




(Reserved for expansion) 


tThe TTCALL mnemonics are defined in a separate MACRO assembler table, 
which is scanned if an undefined OP CODE is found. If the symbol is found 
in the TTCALL table, it is defined as though it had appeared in an appro- 
priate OPDEF statement, for example: 


TYPE: OUTCHRCHARAC 


If OUTCHR is undefined, it will be assembled as though the program con- 
tained the statement: 


OPDEF OUTCHR TTCALL 1, 


This facility is available in MACRO V.44 and later. 



INPUT and INPUT TEST operations (TTCALLs 0, 2, 4, 5, 13 and 14) also clear the effect of the pre- 
vious to type in. 

5. 10.3.1 INCHRW ADR or TTCALL 0, ADR - This command inputs a character into the low-order 
seven bits of location ADR. If there is no character yet typed, the program waits. 

5.10.3.2 OUTCHR ADR or TTCALL 1, ADR - This command outputs to the user's terminal the char- 
acter in location ADR. Only the low order 7 bits of the contents of ADR are used. The remaining 
bits do not need to be zeroes. 

If there is no room in the output buffer, the program waits until room is available. ADR may be in 
high segment. 
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5.10.3.3 INCHRS ADR or TTCALL 2, ADR - This command Is similar to INCHRW, except that it 
skips on a successful return, and does not skip if there is no character in the input buffer; it never 
puts the |ob into a wait. 



TTCALL 8*ADR 

JRST NONE 
JRSl DONE 



5.10.3.4 OUTSTR ADR or TTCALL 3, ADR - This command outputs a string of characters in ASCIZ 
format: 

TTCALL 3*MESSAGE 

MESSAGE: ASCIZ /TYPE THIS OUT/ 



ADR may be in high segment. 

5.10.3.5 INCHWL ADR or TTCALL A, ADR - This command is the same as INCHRW, except that it 
decides whether or not to wait on the basis of lines rather than characters; as such, it is the prefen-ed 
way of inputting characters, because INCHRW causes a swap to occur for each character rather than 
each line (compare DDT and PIP input). In other words, INCHWL returns the next character in the 
line if a break character has been typed. If a break character has not been typed, INCHWL waits. 
Repeated uses of INCHWL return each of the successive characters of the line. 

Note that a control-C character in the input buffer is sufficient to satisfy the condition of a pending 
^ine. Therefore, when the input is done, the control-C is interpreted and the job is stopped. This 
definition of a line also applies to TTCALL 5, and TTCALL 14,. 

5.10.3.6 INCHSL ADR or TTCALL 5, ADR - This command is the same as INCHRS, except that its 
decision whether to skip is made on the basis of lines rather than characters. 

5.10.3.7 GETLCH ADR or TTCALL 6, ADR - This command takes one argument, from location ADR, 
and returns one word, also in ADR. The argument is a number, representing a TTY line. Bits 18 and 
19 of the line number are ignored since terminal numbers begin at 200000. If the argument is negative, 
the line number controlling the program is assumed. If the line number is greater than those defined 

in the system, a zero answer is returned. 



If the input buffer becomes nearly filled, the waiting-of-line condition is satisfied even though no 
break character appears . This is true of all line-mode input operations. 
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The normal answer format is as follows: 



Name 



Bit 



GL.ITY 





GL.CTY 


1 


GL.DSP 


2 


GL.DSL 


3 




4 


GL.HDP 


5 


GL.REM 


6 


GL.RBS 


7 


GL.LIN 


II 




12 


GL.LCM 


13 


GL.TAB 


14 


GL.LCP 


15 


GL.PTM 


16 




17 
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Meaning 

Line is a pseudo TTY. 

Line is the CTY. 

Line is the display console. 

Line is the dotaset data line. 

Obsolete. 

Line is half-duplex. 

Line is a remote TTY. 

Line is at a remote batch station. 

A line has been typed in by the user. 

Obsolete. 

Lower case input mode is on. 

Terminal has tabs. 

Terminal input is not echoed, because device 

is local copy. 

Control Q (paper-tape) switch is on. 

Obsolete. 

200000 + line number. 



5.10.3.8 SETLCH ADR or TTCALL 1 , ADR - This command allows a program to set and clear some of 
the bits for GETLCH. They may be changed only for the job's controlling TTY. Bits 13, 14, 15, and 
16 can be modified. Bits 18 and 19 of the line number argument are ignored. 

Example: 

SETC AC>t-^ 

GETLCH AC 

TLZ AC^ta IT 13 

TLO aCt^IT 14 



SFTLCH 



AC 



5.10.3.9 RESCAN or TTCALL 10, - This command is intended for use only by the COMPIL program. 
It causes the input buffer to be rescanned from the point where the last command began. If bit 35 of E 
is 1 , the error return is given if there is a command in the input buffer. If the input buffer is empty, 
the skip return is given. Obviously, if the UUO is executed other than before the first input, that 
command may no longer be in the buffer. ADR is not used, but it is address checked. 

5.10.3.10 CLRBFI or TTCALL 11,0- This command causes the input buffer to be cleared as if the 
user had typed a number of CONTROL Us. It is intended to be used when an error has been detected 
(e.g., if a user did not want any commands that he might have typed ahead to be executed). 
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5 JO.a.n CLRBFO or TTCALL 12, - This command causes the output buffer to be cleared as If 
the user had typed CONTROL O. It should be used rarely, because usually one wants to see all out- 
put, up to the point of an error. This command is included primarily for completeness. 

5.10.3.12 SKPINC or TTCALL 13, - This command skips if the user has typed at least one 
character. If does not skip if no characters have been typed; however, it never inputs a character. 
It is useful for a computer-based program that wants to occasionally check for input and, if any, go 
off to another routine (such as FORTRAN operating system) to actually do the input. 

5.10.3.13 SKPINL or TTCALL 14, - This command is the same as SKPINC, except that a skip 
occurs if the user has typed at least one line. 

5.10.3.14 lONEOU ADR or TTCALL 15, E - This command outputs the low-order eight bits of the 
contents of E as an image character to the terminal . 

5.10.4 GETLIN AC, or CALLI AC, 34 - This UUO returns the SIXBIT physical name of the terminal 
that the job is attached to. 

The call is: 

GETUN AC, ;OR CALLI AC, 34 

The name is returned left justified in the AC. If the job issuing the UUO is currently detached, the 
left half of AC contains a on return . The right half of AC contains the right half of the physical 
name of the terminal to which the job was most recently attached. Therefore, by testing the left half 
of AC, jobs can determine if they are attached to a terminal. 

Example: 

CTY or TTY3 or TTY30 
This UUO is used by the LOGIN program to print the TTY 



name. 



5.10.5 TRMNO. AC, or CALLI AC, 115^ 

This UUO is used to obtain the number of the terminal cun-ently controlling a particular job. This 
terminal number can then be used as the argument to the GETLCH (refer to Paragraph 5.10.3.7) and 
TRMOP. (refer to Paragraph 5.10.6) UUOs. 



This UUO depends on FT5UUO which is normally off in the DECsystem-1040. 
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MOVE AC, \ch number 

TRMNO. AC, ;or CALLI AC, 115 

error return 
normal return 

On a normal return, the right half of AC contains tiie universal I/O index (.UXxxx) for the terminal. 
The range of values is 200000 to 200777 octal. The symbol .UXTRM (octal value 200000) is the offset 
for the terminal indices. 

On an error return, if the AC is unchanged, the UUO is not implemented. If the AC contains zero, 
one of three errors occwred: 

1) The job is currently detached and therefore, no terminal is controlling it. 

2) The job number is unassigned; i .e., there is no such job. 

3) The job number is out of range and therefore illegal . 

The particular error condition can be determined from the JOBSTS UUO (refer to Paragraph 5.9.4.4). 

For example, 

MOVEI AC, number 
TRMNO. AC, 

JRST .+2 
JRST OK 

JUMPN AC, not implemented 
MOVNI AC, number 
JOBSTS AC, 

JRST illegal number 
JUMPL AC, detached 
JRST no |ob assigned. 

5.10.6 TRMOP. AC, or CALLI AC, 116 

This UUO allows the user to conlrol, examine, and modify information about any terminal connected 
to the system. Many of the functions of this UUO are extensions to the TTCALL input and output 
functions (refer to Paragraph 5.10.3). Certain functions are privileged, or require that the user have 
the terminal ASSIGNed. Generally, any function is legal for the terminal on which the job issuing 
the UUO is running. In addition, any READ or SKIP function is legal for any terminal if the job 
issuing the UUO 1) has the privilege bit JP.SPM set, 2) is running with the JACCT bit set, or 3) is 
logged in as [1,2] . A SET or output function is legal for any terminal if the job 1) has the privilege 
bit JP.POK set, 2) is running with the JACCT bit set, or 3) is logged-in as [1,2] . 



I ' This UUO depends on FT5UUO which is normally off in the DECsystem-1040. 
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The call is: 



;orCALLI AC, 116 



MOVE AC, [XWD N, ADR] 
TRMOP. AC, 
error return 
normal return 

ADR: function code 
ADR+1: universal I/O index 



ADR is the address of the argument block and N is the length (N must be at least 2). The first word of 
the argument block contains the code for the requested function. The second word contains the uni- 
versal I/O index of the terminal to be affected (.UXTRM + line number). This index is in the same 
format as returned by the TRMNO. UUO (refer to Paragraph 5.10.5). Remaining arguments in the 
argument block depend on the particular function used. 

Function codes are defined within the following ranges: 

0000-0777 Perform a specific action. 

1000-1777 Read a parameter. 

2000-2777 Set a parameter. 

3000-3777 Reserved for DEC customers. 



The functions within the range 0000-0777 are as follows: 



.TOSIP 


1 


.TOSOP 


2 


.TOCIB 


3 


.TOCOB 


4 


.TOOUC 


5 


.TOOIC 


6 



.TOOUS 

.TOINC 

.TOIIC 

.TODSE 
.TODSC 



10 

n 

12 
13 



.TODSF 



14 



Skip if terminal input buffer is not empty. 

Skip if terminal output buffer is not empty. 

Clear terminal input buffer. 

Clear terminal output buffer. 

Output character to terminal from ADR+2 (not yet implemented). 

Output image mode (8-bit) character from ADR+2 (not yet im- 
plemented). 

Output ASCIZ string to terminal from address at ADR+2 (not yet 
implemented). 

Input character from terminal to AC, normal mode (not yet 
implemented). 

Input character from terminal to AC, image mode (not yet im- 
plemented). 

Enable modem for outgoing call. 

Enable and place outgoing call on modem with dialer. Phone 
number of up to 17 digits is stored in 4-bit bytes in ADR+2 and 
ADR+3 and is terminated by a 17 byte. If caller must wait for 
a second dial tone (e.g., after dialing a 9), a 16 byte results 
in a 5 second wait. 

Hang up modem (i.e., disconnect call). 
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The READ (1000-1777) and SET (2000-2777) functions are parallel; i.e., if function 1002 reads a 
particular parameter, then function 2002 sets the same parameter. Values for the READ functions are 
returned in AC; arguments to the SET functions are given in ADR+2. One-bit quantities are not 
range-checked; instead bit 35 of ADR+2 is stored. The following description of the READ function 
codes indicate if there is a corresponding SET function code. 



Read Code 


Range 


1000 


1 bit 


1001 


1 bit 


1002 


1 bit 


1003 


1 bit 


1004 


1 bit 


1005 


1 bit 


1006 


1 bit 


1007 


1 bit 


1010 


1 bit 


1011 


to 377 


1012 


16. to 200. 


1013 


1 bit 


1014 


1 bit 


1015 


1 bit 


1016 


1 bit 


1017 


to 3 


1020 


1 bit 


1021 


1 bit 


1022 


1 bit 







1023 


to 63. 


1024 


to 63. 


1025 


1 bit 



Description 

Output in progress (.TOOIP) 

Terminal at monitor mode (.TOCOM) 

Paper tape mode (.TOXON) 

Lower case (if set, no lower case) 
(.TOLCT) 

Slave switch (.TOSLV) 

Tab switch (if = spaces, if 1 = tab) 
(.TOTAB) 

Form switch (if = linefeeds, if 1 = 
formfeeds) (.TOFRM) 

Local copy switch (if set, no echo) 
(.TOLCP) 

Free CR-LF switch (if set, no CR-LF) 
(.TONFC) 

Horizontal position of carriage 
(.TOHPS) 

Can-iage width (.TOWID) 

TTY GAG bit (if set, NO GAG) 
(.TOSND) 

Half-duplex line (.TOHLF) 

Remote line (.TORMT) 

Display terminal (.TODIS) 

Filler class (.TOFLC) 



Corresponding SET 

No 
No 
Yes 
Yes 

Yes 
Yes 

Yes 

Yes 

Yes 

No 

Yes 
Yes 

Yes, privileged 

Yes, privileged 

Yes, privileged 

Yes 
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Paper tape enabled (.TOTAP) Yes 

Paged display mode (also set and Yes 

cleared by SET TTY PAGE)(.TOPAG) 

Suspended output (need XON to re- Yes 

sume) (also set by XOFF, formfeed, or 
page size exceeded, if paged display 
mode)(.TOSTP) Not inplemented. 

Page size (number of lines) ( also set by Yes 

SET TTY PAGE)(.TOPSZ) Not implemented. 

Page counter (number of lines output Yes 

this page)(.TOPCT) 

Suppress blank lines on output (0 = Yes 

normal output and 1 = suppress multiple 
linefeeds) and convert formfeeds and 
vertical tabs to linefeeds (also set and 
cleared by SET TTY BLANK)(,TOBLK) 
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Suppress ALTmode conversion on input 
(0 = ]75 and 176 converted to 033 and 
1 = no conversion) (also set and cleared 
bySETTTYALTK.TOALT) 
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Corresponding SET 
Yes 



On an error return, AC is either unchanged or contains an error code. 



AC 

unchanged 

1 
2 
3 
4 
5 



Name 



TOPRC% 
TORGB% 
TOADB% 
TOIMP% 
TODIL% 



Meaning 

UUO is not implemented. 

The requested function is not implemented. 

User is not privileged to perform this function. 

Argument is out of range . 

Argument list length or address is illegal. 

Dataset activity to a non-dataset terminal. 

Subfunction failed (e.g., call not properly completed from dialer). 



5.10.7 File Status (Refer to Appendix D) 
The file status of the terminal is shown below. 
Standard Bits 

SETBYUSEF? 
SET BY MONITOR 




Bit 18 - lO.IMP 
Bit 23 -lO.ACT 



10-0566 

TTY is not assigned to a job (for image mode input 
processing). ^ 

Device is active. 



18 



22 24 26 



UNUSED 






Device Dependent Bits 



18 



2t 



24 



27 



SET BY USER 



30 33 



10-0567 



35 



mu 



Bit 27 -lO. TEC 



Bit 28 - lO.SUP 
Bit 29 -lO.FCS 



This bit causes 001 through 037, 175, and 176 (octal) 

to echo the character exactly as received by the monitor. 

I here is no special echo (e.g., $ or t x). 

Suppresses echoing on the terminal. 

Full character set. Pass all characten; except lower case 

and I C. Lower case is controlled by the SET TTY LC 

command and its corresponding TRMOP. UUO function. 
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18 19 21 24 28 30 33 35 



SET BY MONITOR 



Bit 19 - lO.DER Ignore interrupts for three-fourths of a second. 

Bit 20 - lO.DTE Echo failure has occurred on output. 

Bit 21 - lO.BKT Character was lost on typein. 

5.10.8 Paper-Tape Input from the Terminal (Full -Duplex Software) 

Paper-tape input is possible from a terminal equipped with a paper-tape reader that is controlled by 
the XON (tQ) and XOFF (tS) characters. When commanded by the XON character, the terminal 
service reads paper tapes, starting and stopping the paper tape as needed, and continuing until the 
XOFF character is read or typed in. While in this mode of operation, any RUBOUTS will be discarded 
and no free line feeds will be inserted after carriage returns. Also, TABS and FORMFEEDS will not be 
simulated on a Teletype Model 33 to ensure output of the reader control characters. To use paper 
tape processing, the tenninal with a paper-tape reader must be connected by a full-duplex connection 
and only ASCII paper tapes should be used. 

The correct operating sequence for reading a paper tape in this way is as follows: 

.R PIP J 

*DSK:FILE*-TTY:tQ J 

THIS IS WHAT IS ON" TAPE 

WRE OF THE SAME 

LAST LINE tZ 

*tC 

5.10.9 Paper-Tape Output at the Terminal (Full-Duplex Software) 

Paper-tape output is possible on any terminal-mounted paper-tape punch, which is controlled by the 
TAPE, AUX ON (tR) and TAPE, AUX OFF (tT) characters. The punch is connected in parallel with 
the keyboard printer, and therefore, when the punch is on, all characters on the keyboard are punched 
on tape. 

LT33B or LT33H Teletypes can have the reader and punch turned off and on under program control. 
When commanded by the AUX ON character, the TTY service punches paper tapes until the AUX OFF 
character is read or typed in. The AUX OFF character is the last character punched on tape. 

When writing programs to output to the terminal paper-tape punch, the user should punch several 
inches of blank tape before the AUX OFF character is transmitted. This last character may then be 
torn off and discarded. 
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CHAPTER 6 

I/O PROGRAMMING FOR DIRECTORY DEVICES 



This chapter explains the unique features of the standard directory devices. Each device accepts the 
programmed operators explained in Chapter 4, unless otherwise indicated. Table 6-1 is a summary of 
the characteristics of the directdry devices. Buffer sizes are given in octal and include three book- 
keeping words. The user may determine the physical characteristics associated with a logical device 
name by calling the DEVCHR UUO (refer to Paragraph 4.10.2) . 



Table 6-1 
Directory Devices 



Device 



DECtape 



Fixed- 
Head 
Disk 



Disk Pack 



Physical 
Name 



DTAO, DTAl , 
...,DTA7 
DTBO, DTBl, 
...,DTB7tt 



DSK, FHA, 
FHAO, ..., 
FHA3 



DSK, DPA, 
DPAO, ..., 
DPA7 



Controller 
Number 



TDIO 
551(PDP-6) 



RCIO 



RPIO 



Unit 
Number 



TU55 
555(PDP-6) 



RDIO 
RMIOB 



RPOl 
RP02 



Programmed 
Operators 



INPUT, IN 
OUTPUT, OUT 
LOOKUP, ENTER 
MTAPE, USETF, 
USETO, USETJ 
UTPCLR 

INPUT, IN 
OUTPUT, OUT 
LOOKUP, ENTER 
RENAME, SEEK 
USETO, USETI 

INPUT, IN 
OUTPUT, OUT 
LOOKUP, ENTER 
RENAME, SEEK 
USETO, USETI 



Data 
Modes 



A,AL,I 

B,IB 

DR,D 



A,AL,I 

B,IB 

DR,D 



A,AL,I 

B,IB 

DR,D 



Buffer 
Sizes 
(Octal '^) 



202 



203 



203 



A ncv^i^f M.?^'"^'''''^ '° ""^f^^ """"^ '^^"'"^ ^^ calculated rather than assumed by user programs. 
A UtVbiz, UUO may be employed. 

Recognized if dual DECtape controller is supported. 
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6.1 DEC TAPE 

The device mnemonic is DTAO, DTAl , . . . , DTA7; the buffer size is 202g words (177g user dato, 200g 
transferred). On systems with dual DECtope controllers, the drives on the second controller have the 
mnemonic DTBO, DTBl, ..., DTB7. 

6.1 .1 Data Modes 

Two hundred words are written. The first word is the link plus word count. The following 177q words 

are data supplied to and from user programs. 

6.1 .1 .1 Buffered Data Modes - Data is written on DECtape exactly as it appears In the buffer and 
consists of 36-bit words. No processing or checksumming of any kind is performed by the service rou- 
tine. Hie self-checking of the DECtape system is sufficient assurance that the data is correct. Refer 
to Paragraph 6.1 .2 for further information concerning blocking of information. 

6.1.1.2 Unbuffered Data Modes - Data is read into or written from anywhere in the user's core area 
without regard to the standard buffering scheme. Control for read or write operations must be via a 
command list in core memory. The command list format is described in Chapter 4. On the KI10, if the 
lOWD list is modified as the result of I/O performed (i.e., an INPUT UUO reads into the lOWD list) 
and the word count of any of the lOWDs read into the list is greater than the following value: 

(maximum word count specified in original list-2)/512 + 2 

then the job is stopped and the monitor types 

ADDRESS CHECK AT USER adr 

File -structured dump mode data is automatically blocked into standard-length DECtape blocks by the 
DECtape service routine. Each block read or written contains 1 link word plus 1 to 177g data words. 
Unless the number of data words is an exact multiple of the data portion of a DECtape block (177g), 
the remainder of the last block written after each output programmed operator is wasted. The input pro- 
grammed operator must specify the same number of words that the corresponding output programmed 
operator specified to skip over the wasted fractions of blocks. 

6.1.2 DECtape Format 

A standard reel of DECtape consists of 578 (1102g) prerecorded blocks each capable of storing 128 
(200J 36-bit words of data. Block numbers that label the blocks for addressing purposes are recorded 
between blocks. These block numbers run from to 1 101 g. Blocks 0, 1 , and 2 are normally not used 
during timesharing and are reserved for a bootstrap loader. Block IOO^q (144g) is the directory block, 
which contains the names of ail files on the tape and information relating to each file. Blocks 3^q 
through 99 -^ (1-1 43g) and 101^^ through 577 ^^ (145-11 01 g) are usable for data. 

If, in the process of DECtape I/O, the I/O service routine is requested to use a block number larger 

than 1 lOlo or smaller than 0, the monitor sets the lO.BKT flag (bit 21) in the file status and returns. 
8 
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6.1.3 DECtape Directory Format 

The directory block (block 100,^) of a DECtape contains directory information for all files on that 
tape; a maximum of 22 files can be stored on any one DECtape (see Figure 6-1). 



83 WORDS'^ 



22 WORDS" 



22 WORDS- 



BLOCK 12 3 4 5 6 7 

1*1*1 I I T-T-n ^ 

BIT 35 CONTAINS 
hHIGH ORDER DIGITS 
OF CREATION DATES 



L 82 
83 
84 

105 
106 

126 
127 



FILENAME 1 



HI 



FILENAME 2 



EXTENSION I MM LOW DATE 1 



BIT 35 UNUSED 



EXTENSION 2 ** LOW DATE 2 



TAPE LABEL 



NOTES • 

^ Reserved for system, contains 36 as does block I44q for the 
directory. ° 

^** For zero-compressed files, this area holds the number of IK 
blocks ( - 1) needed to load the file (up to 64K ). 

+ Represents blocks 1102 through 1105, which are not available 
contains 37q . 



Figure 6-1 DECtape Directory Format 

The first 83 words (0 through 82^^) of the directory block contains slots for blocks 1 through 577 on a 
DECtape. Each slot occupies five bits (seven slots are stored per word) and represents a given block 
on the DECtape. Each slot contains the number of the file (l-26g) occupying the given block. This 
allows for 581 slots (83 words x 7 slots per word). The four extra slots represent nonexistent blocks 

1102 through 1105_. 
o 

Bit 35 of the first 66 words (0 through 65^^) of the directory block contain the high order 3 bits of 
the 15-bit creation date of each file on the DECtape. (Note that the low order 12 bits of the creation 
date of each file are contained in words 105 through 126^^. This split format allows for compatibility 
among monitors and media as old as 1964.) The high order 3 bits of the 15-bit creation date for file 1 
are contained in bit 35 of words 0, 22, and 44. Word 44 contains the first (most significant) digit; word 
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22 contains the second and word contoins the third. The high order digits for file 2 are contained 
in bit 35 of words 1, 23, and 45 with the digits in the same order as described for file 1 . The high 
order digits for the remaining files are organized in the same fashion. 

Words 83 through 104. ^ of the directory block contain the filenames of the 22 files that reside on the 
DECtape. Word 83 contains the filename for file 1, word 84 contains the filename for file 2. File- 
names are stored in SIXBIT code. 

The next 22 words of the directory block (words 105 through 126^^) primarily contain the filename 
extensions and the low order part of the creation dates of the 22 files that reside on the DECtape, in 
the same relative order as their filenames. The bits for each word are as follows: 

Bits - 17, „ The filename extension in SIXBIT code. 

10 
Bits 18 - 23, « The number of IK blocks minus 1 needed to load the 

file (maximum value is 63). This information is stored 

for zero-compressed files only. 



10 



Bits 24 - 35,^ The low order 12 bits of the date on which the file 



^^ was created. (Note that the high order digits are 

encoded in bit 35 of words through 65, q). The 
creation date is computed with the following formula: 
((year- 1964) * 12 + (month- 1)) * 31 + day -1 

Word 127 - of the directory block is the tape label . 

The message 

BAD DIRECTORY FOR DEVICE DTAn: EXEC CALLED FROM USER LOC n 
occurs when any of the following conditions are detected: 

a . A parity error occurred while reading fbe directory block. 

b. No slots are assigned to the file number of the file. 

c . "nie tape block, wliich may be the first block of the file (i.e., the first block for the 
file encountered while searching backwards from the directory block), cannot be 
read. 

Ordinary user programs never manipulate DECtape directories explicitly since the LOOKUP and ENTER 
programmed operators (refer to Paragraphs 6. 1 .5. 1 and 6. 1 .5.2) automatically record all necessary 
entries in the directory for the user. These programmed operators have all the capability needed to 
process the name and creation dote of a file. However, a small number of special purpose programs 
do process directories by explicit action rather than using the LOOKUP and ENTER operators. For 
such programs, the following examples illustrate methods for 1) assembling the 15-bit creation date 
and 2) storing the 15-bit creation dote. The number of the file (an integer from 1 to 22) is in register 
PI and the directory block begins at location DIRECT. 
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Example 1 Special Purpose Assembly of the Creation Date 



LDB 


Tl, [POINT U, DIRECT+ tD104 (PI), 35] ; 


MOVEI 


T2, ] ; 


TDNE 


T2, DIRECT-1 (PI) ; 


TRO 


Tl, 1B23 ; 


TDNE 


T2, DIRECT+ tD21 (PI) 


TRO 


Tl, 1B22 


TDNE 


T2, DIRECT+tD43(Pl) ; 


TRO 


Tl, 1B21 


le 2 Specia 


1 Purpose Storage of the Creation Date 


DPB 


T1, [POINT 12, DIRECT+tD104 (PI), 35] ; 


MOVEI 


T2, 1 


ANDCAM 


T2, DIRECT-1 (PI) ; 


TRNE 


Tl, 1B23 ; 


lORM 


T2, DIRECT-1 (PI) 


ANDCAM 


T2, DIRECT+tD21 (PI) ; 


TRNE 


Tl, 1B22 


lORM 


T2, DIRECT+tD21 (PI) ; 


ANDCAM 


T2, DIRECT+tD43(Pl) 


TRNE 


Tl, 1B21 ; 


lORM 


T2, DIRECT+tD43(Pl) 
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GET LOW PART 
SET UP TO TEST LOW BIT 
IF SET IN DIRECTORY 
THEN SET BIT IN DATE 
REPEAT FOR EACH BIT IN 
HIGH PART OF DATE 



SAVE LOW PART 
SET UP TO MARK LOW BIT 
CLEAR DIRECTORY BIT 
IF BIT IN DATE SET, 
SET DIRECTORY BIT 

REPEAT FOR EACH BIT IN 
HIGH PART OF DATE 



6.1 .4 DECtape File Format 

A file consists of any number of DECtape blocks. 



END 



DIRECTORY- 



BEGIN 

10-0573 



Figure 6-2 Format of a File on Tape 



Each block contains the following: 
Word Left half 

Right half 



Words 1 through 177^ 



The link . The link is the block number of the next 
block in the file. If the link is zero, this block is 
the last in the file. 

Bits 18 through 27: the block number of the first 

block of the file. Bits 28 through 35: a count of 

the number of words in this block that are used 

(maximum 177q). 
o 

Data packed exactly as the user placed in his buffer 

or in dump mode files, the next 177 words of memory. 
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LINK 



FIRST BLOCK 
NUMBER 



WORD 
COUNT 



DATA 



Figure 6-3 Format of a DECtape Block 

6.1 .4.1 Block Allocation - Normally, blocks are allocated by starting with the first free block 
nearest the directory and going backwards to the front of the tape (block 0). When the end of the 
tape is reached, the direction of the scan is reversed. Blocks are not written contiguously; rather 
they are separated by a spacing factor. This allows the drive to stop and restart to read the next 
block of the file without having to back up the tape. The spacing factor is normally four, but for 
dump mode and UGETF followed by an ENTER, the spacing factor is two (refer to Paragraph 6.1 .6,3), 



6.1 .5 l/O Progra mm i ng 

DECtape is a directory device; therefore, file selection must be performed by the user before data is 
transferred. File selection is accomplished with LOOKUP and ENTER UUOs. The UUO format is as 
follows: 

UUO D, E 

where D specifies the user channel associated with this device, and E points to a four-word parameter 
block. The parameter block has the following format: 



E 
E+1 

E + 2 
E + 3 



FILE 


EXT 


HIGH 
DATE 





BLOCK 
# 





#OFIK 
BLOCKS 


LOW 
DATE 


-N 


ADR-1 1 



(continued on next page) 



6-6 



June 1973 



-541- 



MONITOR CALLS 



where 

FILE is the filename in SIXBIT ASCII. 

EXT is the filename extension in SIXBIT ASCII. 

HIGH DATE contains the high order 3 bits of the creation date. 

BLOCK # is the number of the first block of the file. 

# of IK blocks is the number of blocks needed to load the file 
if the file is a zero-compressed file (bits 18-23). 

LOW DATE contains the low order 12 bits of the date on which 
the file was originally created (bits 24-35). The format is the 
same as that used by the DATE UUO. 

-N is the negative word length of the zero-compressed file. 

ADR-1 is the core address of the first word of the file minus 1 . 

Location E + 3 is used for zero-compressed files. 

6. 1 .5. 1 LOOKUP D, E - The LOOKUP programmed operator sets up an input file on channel D. 
The contents of location E and E + 1 (left half) are matched against the filenames and filename exten- 
sions in the DECtape directory. If no match is found, the error return is taken (refer to Appendix E). 
If a match is found, locations E + 1 through E + 3 are filled by the monitor, and the normal return is 
taken (refer to Table 6-2). Refer to Section d. of Paragraph 6.2.8. 1 for sample code of assembling 
the 15-bit creation date. 

Table 6-2 
LOOKUP Parameters 



On Call 


On Return 


Parameter 


Use^ 


Contents 


Parameter 


Use^ 


Contents 


E 
E+ 1 

E + 2 
E + 3 


A 
A 

I 
I 


SIXBIT /FILE/ 
SIXBIT /EXT/ 


E 
E+ 1 

E + 2 
E + 3 


V 
V 

V 
V 


SIXBIT /FILE/ 

LH = SIXBIT /EXT/ 
RH = high order 3 
bits of 15-bit cre- 
ation date (Bits 18-20) 
unused (Bits 21-25) 
first block * (Bits 26-35) 

LH = 

RH = #of IK blocks 
(Bits 18-23) ft 

low order 12 bits of 
15-bit creation date 
(Bits 24-35)tt 

lOWD LENGTH, 
ADRtt 


tA = argument from user program, V = value from monitor, I = ignored. 
ttFor zero-compressed files only. 
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The first block of the file is then found as follows: 

a . The first 83 words of the DECtape directory are searched backwards, beginning 
with the slot immediately prior to the directory block, until the slot containing 
the desired file number is found . 

b. The block associated with this slot is read in and bits 18 through 27 of the first 
word of the block (these bits contain the block number of the first block of the 
file) are checked. If the bits are equal to the block number of this block, then 
this block is the first block; if not, then the block with that block number is 
read as the first block of the file. 



6.1 .5.2 ENTER D, E - Tlie ENTER programmed operator sets up an output file on channel D. The 
DECtape directory is searched For a filename and filename extension that match the contents of 
location E and the left half of location E + 1 . If no match is found and there is room in the directory, 
the monitor records the information in locations E through E +2 in the DECtape directory (refer to 
Table 6-3). An error return is given if there is no room in the directory for the file (refer to Appendix 
E). Refer to Paragraph 6.2.8.3 for a special note on error recovery. If a match is found, the new 
entry replaces the old entry, the old file is reclaimed immediately, and the monitor records the file 
information. This process is called superseding and differs from the process on disk in that, because 
of the small size of DECtape, the space is reclaimed before the file is written rather than after. Refer 
to Section d. of Paragraph 6.2.8. 1 for sample code for setting the 15-bit creation date. 



Table 6-3 
ENTER Parameters 



On Call 


On Return 


Parameter 


Use^ 


Contents 


Parameter 


Use"*" 


Contents 


E 


A 


SIXBIT /FILE/ 


E 


V 


SIXBIT /FIL^ 


E + 1 


A 


LH = SIXBIT/EXT/ 
RH = high order 3 
bits of 15-bit cre- 
ation date (bits 
18-20). 


E+ 1 


V 


LH = SIXBIT /EXT/ 
RH = high order 3 
bits of 15-bit cre- 
ation date (bits 
18-20). 


E + 2 


A 


RH = low order 12 
bits of desired 15- 
bit creation date 
or 0. (0 implies 
current date) 


E+2 


V 


RH = low order 12 
bits of 15-bit cre- 
ation date (bits 
24-35). 


E + 3 


I 




E + 3 


I 


- 


A = argun 


lent from u 


ser program, V = value f 


rom monitor. 


I = ignored . 
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6.1 .5.3 RENAME D, E - The RENAME programmed operator alters the filename or filename extension 
of an existing file, or deletes the file directory from the DECtape associated with channel D. If lo- 
cation E contains a 0, RENAME deletes the directory of the specified file; otherwise, RENAME 
searches for the file and enters the information specified in location E and E + 1 into the DECtape 
directory (refer to Table 6-4). RENAME must be preceded by a LOOKUP or an ENTER, to select the 
file that is to be RENAMED, and a CLOSE. The error return is given if a LOOKUP has not been done 
(refer to Appendix E). Refer to Paragraph 6.2.8.3 for a special note on error recovery. 
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RENAME Parameters 




On Call 




On Return 


Parameter 


Use^ 


Contents 


Parameter 


Use^ 


Contents 


E 


A 


SIXBIT /FILE/ 
or 


E 


V 


SIXBIT /FIL^/ 


E+1 


A 


LH = SIXBIT /EXT/ 
RH = high order 3 
bits of 15-bit cre- 
ation date (bits 
18-20). 


E+1 


V 


, LH = SIXBIT /EXT/ 
RH = high order 3 
bits of 15-bit cre- 
ation date (bits 
18-20). 


E + 2 


A 


RH = low order 12 
bits of 15-bit cre- 
ation date or (0 
implies current date). 


E + 2 


V 


RH = low order 12 
bits of 15-bit cre- 
ation date (bits 
24-35). 


E + 3 


I 


- 


E + 3 


I 


- 


'A = argu 


J — _ , — __ , 

ment from user program, V = value from monitor 


, I = ignored . 



Unlike on disk, a DECtape RENAME works on the last file LOOKUPed and ENTERed for the device, 
not the last file for this channel . The UUO sequence required to successfully RENAME a file on 

DECtape is as follows: 

D,E 



LOOKUP 
CLOSE D, 
RENAME 



D,E1 



ENTER 
CLOSE D, 
RENAME 



D,E 
D,E1 
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6. 1 .5.4 INPUT, OUTPUT, CLOSE, RELEASE - When performing nondump Input operations, the 
DECtape service routine reads the links In each block to determine what block to read next and when 



to raise the EOF flag. 



When an OUTPUT Is given, the DECtape service routine examines the left half of the third word In the 
output buffer (the word containing the word count In the right half) . If this half coniulns -1 , It Is 
replaced with a before being written out, and the file Is thus terminated. If this half word^ls greater 
than 0, It Is not changed and the service routine uses It as the block number for the next OUTPUT. If 
this half word Is 0, the DECtape service routine assigns the block number of the next block for the 
next OUTPUT. 
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For both INPUT and OUTPUT, block TOO (the directory) is treated as an exception case. If the user's 
program gives 

USETID, 144g 

to read block 100, it is treated as a 1 -block file. 

The CLOSE operator places a -1 in the left half of the first word in the last output buffer, thus termi- 
nating fhe file. 

The RELEASE operator writes the copy of fbe directory, which is normally kept in core onto block 100, 
but only if any changes have been made. Certain console commands, such as KJOB or CORE 0, 
perform an implicit RELEASE of all devices and, thus, write out a changed directory even though the 
user's program failed to give a RELEASE. 

6.1 .6 Special Programmed Operator Service 

Several programmed operators are provided for manipulating DECtape. These UUOs allow the user to 
manipulate block numbers and to handle directories. 

6.1 .6. 1 USETI D, E - The USETI programmed operator sets the DECtape on channel D to input block 
E next. Since the monitor reads as many buffers as it can on INPUT, it is difficult to determine which 
buffer the monitor is processing when the USETI is given. Therefore, the INPUT following the USETI 
may not obtain the buffer containing the block specified. However, if a single buffer ring is used, 
the desired block is retrieved since the device must stop after each INPUT, Alternatively, if bit 30 
(lO.SYN) of the file status word is set via an I NIT, OPEN, or SETSTS UUO, the device stops after 
each bufferful of data on an INPUT so that the USETI will apply to the buffer supplied by the next 
INPUT. 

6.1 .6.2 USETO D, E - The USETO programmed operator sets the DECtape on channel D to output 
block E next. With multiple-buffered I/O, the output following the USETO may not apply to the 
buffer containing the specified block, since the monitor transfers as many buffers as possible with each 
OUTPUT. Therefore, a single buffer ring should be used, or bit 30 (lO.SYN) of the file status word 
should be set. Refer to Paragraph 6. 1 .6. 1 . 

6.1 .6.3 UGETF D, E - The UGETF programmed operator places the number of the next free block of 
the file in the user's location E. 
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If UGETF is followed by an ENTER, the rrranitor modifies its algorithm in the following manner: 

1) the first block is written nearest the front of the tape instead of nearest 
the directory. 

2) the spacing factor is changed to 2 instead of 4 so that very large programs 
can fit almost entirely in a forward direction. 

This feature allows user programs, such as PIP, to write SAV format files which can be read by the 
executive mode utility program TENDMP (see the DECsystem-10 Software NotebocAis). 

6.1 .6.4 UTPCLR AC, or CALLI AC, 13 - The UTPCLR programmed operator clears the directory of 
the DECtape on the device channel specified in the AC field. A cleared directory has zeroes in the 
first 83 words except in the slots related to blocks 0, 1,2, and 100, q and nonexistent blocks 1102 
through 1 105g. Only the directory block is affected by UTPCLR. ITiis programmed operator is a no- 
operation if the device on the channel is not a DECtape. 

6.1 .6.5 MTAPE D, 1 and MTAPE D, 11 - MTAPE D, 1 rewinds the DECtape and moves it into the end 
zone at the front of the tape. MTAPE D, 1 1 rewinds and unloads the tape, pulling the tape completely 
onto the left-hand reel , and clears the directory-in-core bit. These commands affect only the physical 
position of the tape, not the logical position. When either is used, the user's job can be swapped out 
while the DECtape is rewinding; however, the job cannot be swapped out if an INPUT or OUTPUT is 
done while the tape is rewinding. 

6.1 .6.6 DEVSTS UUO - After each interrupt, the DECtape service routine stores the results of a 
CONI in the DEVSTS word of the device data block. The DEVSTS UUO is used to return the contents 
of the DEVSTS word to the user (refer to Paragraph 4.10.1). 

6.1 .7 File Status (Refer to Appendix D) 

The file status of the DECtape is shown on the next page. 
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Standard Bits 



18 21 24 27 30 33 35 



SET BY USER 



SET BY MONITOR 



H 




I 1 cz 



Bit 18-IO.IMP 

Bit 19-IO.DER 
Bit 20 -lO. DTE 
Bit 21 -IO.BKT 
Bit 22 -lO.EOF 

Bit 23 - lO.ACT 



An attempt was made to read block in nonstandard 
dump mode. 

Data was missed. 

Parity error. 

Block number is too large or tape is full on OUTPUT. 

EOF mark encountered on input. No special character 
appears in buffer . 

Device is active. 

«8 2t 24 27 30 33 35 



u 



Device Dependent Bits 



SET BY USER 



1? 2| 24 27 28 29 30 33 35 

m 



Bit 28 -lO.SSD 



Bit29-IO.NSD 



DECtape is in semi-standard I/O mode. The setting of 
this bit is recognized only if bit 29 (nonstandard I/O mode) 
is on. Semi-standard mode is similar to nonstandard mode 
except, 1) block numbers are checked for legality, and 
2) the tape is started in the same direction as it was pre- 
viously going. 

DECtape is in a nonstandard-I/O mode format as opposed 
to standard-I/O mode. No file-structured operations are 
performed on the tape. Blocks are read or written se- 
quentially; no links are generated (output) or recognized 
(input). The first block to be read or written must be set 
by a USETI or USETO. In nonstandard-I/O mode, up to 
2008 words per block are read or written as user data (as 
opposed to the standard mode of 1 link plus word count 
followed by 1778 words). No dead reckoning is used on 
a search for a block number as the tape may be composed 
of blocks shorter than 200 words. The ENTER, LOOKUP, 
and UPTCLR UUOs are treated as no-ops. Block of the 
tape may not be read or \yritten in dump mode if bit 29 
is on, because the data must be read in a forward direction 
and block normally cannot be read forward. 
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6.1.8 Important Considerations 

When positioning to a desired block on DECtape, the technique of dead reckoning is used . This means 
that the DECtape service routine starts the DECtape spinning and computes the time it should take to 
reach the desired block. Meanwhile, the service routine performs a service for another user, if any, 
and then returns just before the computed time has elapsed. If the desired block has not been reached, 
this process is repeated until it is successful . This technique is used to keep the controller free for 
other uses v^ile the DECtape is spinning.. 

When an attempt is made to write on a write-locked tape or to access a drive that has no tape mounted, 
the message 

DEVICE DTAn OPERATOR zz ACTION REQUESTED 
is given to the user. When the situation has been rectified, CONT may be typed to proceed. However, 
if this message is output because of an attempt to write on a write-locked tape and any operation that 
causes a RESET to be performed (e.g., a GETor RUN command) is then executed, a RELEASE will be 
done on the DECtape. This RELEASE causes any attempt to write the directory to output the same 
message. To avoid the second output of the message, the user should ASSIGN the DECtape again thus 
causing the DECtape service routine not to write the directory on the RELEASE. 

The DECtape service routine reads the directory from a tape the first time it is required to perform a 
LOOKUP, ENTER, or UGETF; the directory image remains in core until a new ASSIGN command is 
executed from the console. To inform the DECtape service routine that a new tape has been mounted 
on an assigned unit, the user uses an ASSIGN command. The directory from the old tape can be trans- 
ferred to the new tape, thus destroying the information on that tape unless the user reassigns the DEC- 
tape transport every time he nx)unts a new reel . 

Although DECtape is a file-structured blocked device, there is a limit to the number of files that may 
be opened simultaneously on a single DECtape. A given DECtape may be OPENed or INITed on two 
software channels (maximum) at ihe same time, once for INPUT and once for OUTPUT. An attempt to 
INIT on two channels for INPUT or two channels for OUTPUT generates no error indication, and only 
the most recent INIT is effective. This restriction explains why the following examples do not work . 



Example 1 : 



,ii ?ILC0f1 
*TTY:=DTAI:P1,DTA1:PJ 



FILCOM accepts the command string but the comparison does not work because the DECtape cannot 
be associated with the input side of two software channels at the same time. 
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Example 2: 

.R MACRO 

*DTAl :BIN,DTA1 :LST*-DTA2:PR0G 

MACRO accepts the command string but does not produce the desired results because a single DECtape 
cannot be associated with the output side of two software channels at the same time. However, the 
following example works, because only one file is opened for reading and one file for writing. 

.R MACRO , 

*DTA1 :BI[S!-DTA1 : SOURCE 



6.2 DISK 

The device mnemonic is DSK, FHA, DPA; the buffer size is 203g (200g data) words. 

6.2.1 Data Modes 

6.2 .1 .1 Buffered Data Modes - Data is written on the disk exactly as it appears in the buffer. Data 
consists of 36-bit words. 

CAUTION 

All buffered mode operations utilize a 200 octal word 
dafa buffer. Attempts to set up non-standard buffer 
sizes are ignored. In particular, attempting to use 
buffer sizes smaller than 200 words for input result in 
data being read in past the end of the buffer destroy- 
ing what information was there (e.g ., the buffer 
header of the next buffer) . 

6.2 .1 .2 Unbuffered Data Modes - Data is read into or written from anywhere in the user's core area 
without regard to the normal buffering scheme. Control for read or write operations must be via a 
command list in core memory .The command list format is described in Chapter 4. The disk control 
automatically measures dump data into standard-length disk blocks of 200 octal words. Unless the 
number of data words is an exact multiple of the standard length of a disk block (200 words) after each 
command word in the command list, the remainder of that block is wasted. 

6.2.2 Structure of Disk Files 

Tbe file structures of a disk system minimize the number of disk seeks for sequential or random access 
during either buffered or unbuffered I/O . The assignment of physical space for data is performed auto- 
matically by the monitor when logical files are written or deleted by user programs. Files may be any 
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length, and each user may hove as many files as he wishes, as long as disk space is available and the 
user has not exceeded his logged-in quota. Users or their programs do not need to give initial 
estimates of file length or number of files. Files may be simultaneoulsy read by more than one user at 
a time, thus allowing data sharing . A new version of a file may be recreated by one user while other 
users continue to read the old version, thus allowing for smooth replacement of shared programs and 
data files. Finally, one user may selectively update portions of a file, rather than create a new one. 

6.2.2.1 Addressing by Monitor - The file sfructure described in this section is generally transparent 
to the user, and a detailed knowledge of this material is not essential for effective user-mode use of 
the disk. One set of disk-independent file handling routines in the monitor services all disks and drums. 
This set of routines interprets and operates upon file structures, processed disk UUOs, queues disk re- 
quests, and makes optimization decisions. The monitor deals primarily with logical units within file 
structures and converts to physical units in the small device-dependent routines just before issuing I/O 
commands. All queues, statuses, and flags are organized by logical unit rather than by physical unit. 
The device-dependent routines perform the I/O for specific storage devices and translate logical block 
numbers to physical disk addresses. 

All references made to disk addresses refer to the logical or relative addresses used by the system and 
not to any physical addressing scheme involving records, sectors, or tracks, that may pertain to a par- 
ticular physical device. The basic unit that may be addressed is a logical disk block, which consists 
of 200g 36-bit words. 

6.2 .2 .2 Storage Allocation Table (SAT) Blocks - Unique to each file structure is a file named 
SAT. SYS. This file reflects the current status of every addressable block on the disk . Only the 
monitor can modify the contents of SAT. SYS as a result of file creation, deletion, or space allocation, 
although this file may be read by any user. The SAT file consists of bits indicating both the portion of 
file storage in use and the portion that is available. To reduce the size of SAT. SYS, each bit can be 
used to represent a contiguous set of blocks called a cluster . Monitor overhead is decreased by as- 
signing and releasing file storage in clusters of blocks rather than single blocks. 

If a particular bits is on, it indicates that the corresponding cluster is bad or nonexistent or has been 
allocated to a file. It may or may not contain data (i.e., files may contain allocated but unwritten 
clusters). If the bit is off, it indicates that the con-esponding cluster is empty, or available to be 
written on. 

It is recommended that cluster sizes should evenly divide blocks on a unit. In the 5.02 monitor, the 
refresher rounds up the number of clusters to the next highest full cluster. In the 5.03 and later 
monitors, the refresher truncates to the largest number of full clusters. With truncation, the last few 
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blocks are not Included in the addressing space, but may be used for swapping; therefore, they are not 
part of SWAP. SYS even though they are in the swapping space. In addition, any bad blocks in the 
extra blocks are not included in SWAP. SYS. 

6.2.2.3 File Directories - A directory is a file which contains as data pointers to other files on the 
disk. There are three levels of directories in each file structure: 

a. The master file directory (MFD). 

b. The user file directories (UFDs). 



The sub-file directories (SFDs). 



The master file directory consists of two-word entries; the entries are the names of the user file direc- 
tories on the file structure. The first word of each entry contains the project-programmer number of 
the user. The left half of the second word of each entry contains the mnemonic UFD in SIXBIT and 
the right half contains a pointer to the first cluster of the user file directory (see Figure 6-4). The 
main function of the master file directory is to serve as a directory of individual user file directories. 
A continued MFD is the MFDs on all file structures in the job's search list. 



MASTER FILE 
DIRECTORY 



USER FILE 
DIRECTORIES 



DATA FILES 




FILE X 














EXT 1 


' ^ 


1 


FILEY 
















EXT 1 










FILEZ 








EXT 1 




• 
• 
• 















Figure 6-4 Basic Disk File Organization for Each File Structure 



Sub-file directories depend on FTSFD which is normally off in the DECsystem-1040. 
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The entries within a user file directory are the names of files existing in a given project-programmer 
number area within the file structure. The first word of each entry contains the filename in SIXBIT. 
TTie left half of the second word contains the filename extension in SIXBIT, and the right half contains 
a pointer to the first cluster of the file (see Figure 6-4). This pointer specifies both tlie unit and the 
super-cluster of the file structure in which the file appears. The right half of the directory entry is 
referred to as a compressed file pointer (CFP). A contin ued UFD is all the UFDs for the same project- 
programmer number on all file structures in the job's search list. 

When the user is logged-in, each file structure for which he has a quota contains a UFD for his project- 
programmer number. Each UFD contains the names of all the user's files for that file structure only. 
UFDs are created only by privileged programs (i.e., LOGIN in response to a LOGIN command, and 
OMOUNT in response to a MOUNT command). A user is not prevented from attempting to read a file 
in another user's UFD on a file structure for which he does not have a UFD. Whether or not the user is 
successful depends on the protection specified for the file being referenced. 

As an entry in the user file directory, the user can include a sub-file directory (SFD). The sub-file 
directory is similar to the other types of directories in that it contains as data all the names of files 
within the directory. This directory is pointed to by a UFD or a higher-level SFD nested in any 
arbitrary tree structure. The maximum number of nested SFDs allowed is defined via a MONGEN 
question and can be obtained from a GETTAB table (GETTAB table .GTLVD, item 17). Files can be 
written or read in SFDs nested deeper than the maximum but SFDs cannot be created. (There is an 
absolute maximum of 6, including the UFD.) Unlike UFDs, a sub-file directory can be created by 
any program. A continued SFD, or sub-directory, is all of the SFDs on all file structures in the job's 
search list with the same name and path. 

This third level of directory allows groups of files belonging to the same user to be separate from each 
other. This is useful when organizing a large number of files according to function. In addition, 
simultaneous batch runs of the same program for a single user can use the same filenames without 
conflicting with each other. As long as the files are in different sub-file directories, they are unique. 

A file is uniquely identified in the system by a file structure name, a directory path, a filename and 
an extension » The directory path is an ordered list of directory names, starting with a UFD, which 
uniquely specifies a directory without regard to a file structure. The PATH. UUO is used to set or 
read the default directory path fa- a job (refer to Paragraph 6.2.9.1). Default paths can be a job's 
UFD, an SFD in a job's UFD, a UFD different from the job's UFD, or an SFD In another UFD. If a 
default path is not specified, it is the job's UFD. The notation FILE. EXT rPPN,A,B,.. .,N] designates 
the file named FILE. EXT in the UFD TPPN] in the SFD N, which is in the SFD. . ., which is in the 
SFD A. The path to the file named FILE. EXT is rPPN, A, B,...,N]. 
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To improve disk access and core searching times, only UFD names are kept in the MFD (project- 
programmer number 1,1). All system programs and monitor file structure files are contained in another 
project-programmer number directory called the system library. For convenience both to users typing 
commands and to user programs, device name SYS is interpreted as the system library; therefore, no 
special programming is required to read as a specific file from device SYS. In command strings, the 
abbreviation SYSx: represents the system library on file structure DSKx; i.e., SYSA: represents the 
system library on DSKA. 

6.2.2.4 File Format - All disk files (including directories) are composed of two parts: 

a . pure data . 

b. information needed by the system to retrieve this data. 

Each data block contains exactly 200„ words. If a partially filled buffer is output to the disk by a 
user, a full block is written with trailing zeros filling in to make 200« words. A partial block input 
later appears to have a full 2(X)p data words. Word counts associated with individual blocks are not 
retained by the system except in the case of the last block of the file. 

TViere are three links in the chain by which the system references data on the disk . This chain is 
transparent to the user, who might look on the directory as having four-word entries analogous to DEC- 
tapes. The first link is the two-word directory entry that points to the second link, the retrieval infor- 
mation block (RIB). The RIB, in turn, points to the third link, the individual data blocks of the file 
(see Figure 6-5) . 

The retrieval block contains all the pointers to the entire file. Retrieval information associated with 
each file is stored and accessed separately from the data; therefore, system reliability is increased 
because the probability of destroying the retrieval information is reduced. System performance is im- 
proved because the number of positionings necessary for random access is reduced. 

For recovery purposes, a copy of the retrieval information block is written immediately after the last 
data block of the file when a CLOSE is completed. If the first RIB is lost or bad, the monitor can 
recover by allowing a recovery program to use the second RIB; therefore, a data file of n blocks has 
two additional overhead blocks: relative block 0, containing the primary RIB; and relative block 
n + 1 , containing the redundant RIB (refer to Appendix H). 

6.2.3 Access Protection 

Nine bits of the retrieval information of a file are used to indicate the protection of that file. This 
protection is necessary because the disk is shared by many users, each of whom may desire to keep 
certain files from being written on, read, or deleted by other users. The nine bits are divided into 
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three classes because the users are divided into three categories: 1) the owner of the file, 2) the users 
with the same project number as the owner, and 3) all other users. 

Ordinarily, the owner of a file is any user whose programmer number is the same as the programmer num- 
ber of the UFD containing the file, regardless of whether the two proiect numbers match. Therefore, in 
order to maintain only one owner for each file, the installation should not assign the same programmer 
number to different users, no matter how many projects the installation has. A user working on more 
than one project, but having the same programmer number, can reference all his files as an owner under 
each of his project -programmer numbers. 

However, some installations may decide that a user is the owner of a file only when both the project 
and programmer numbers under which the user is logged in match the pair identifying the UFD. If this 
is the case, the same programmer number can be assigned to different users in different projects. This 
allows the task of assigning programmer numbers to be delegated to project leaders without concern for 
duplication since the project numbers will be different from one project to another. However, a user 
working on more than one project cannot have the same owner access to all files that he has written. 

The definition of the owner of a file is specified at monitor generation time with MONGEN(INDPPN). 
No matter how the installation defines an owner, project numbers to 7 are always independent of 
the project-programmer number (i.e., a user with a project number from to 7 is considered the own- 
er of all files with that project number). 

A member of the owner's prelect is any user whose logged-in-pro|ect number is the some as the owner's, 
regardless of his programmer number. 

The three bits associated with each category of iKers are encoded as follows: 

Code Access Protection 

7 Greatest protection, which means no access privileges. 

However, the ovmer may LOOKUP the file so that he 
can change the protection to a less reslrictive code via 
a RENAME. Thus for the owner, this code is equivalent 
to codes 6 and 5. 

6 Execute-only. This disables user meddling and examining 

(DUMP, DCORE, D, E, SAVE, SSAVE, START n, CSTART n, 
DDT, COREn) with the error message 7ILLEGAL WHEN 
EXECUTE ONLY. An error return is given on a LOOKUP 
to an execute-only file to all users except the owner of the file. 

5 Read, execute. 

4 Append, read, execute. 

3 Update, append, read, execute. 

2 Write, update, append, read, execute. 

1 Rename, write, update, append, read, execute. 

Change protection, rename, write, update, append, read, 

execute. 
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The following example illustrates the nine-bit protection field of a file that has a protection of 057. 

owner project all other 
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This code means: 

1) The owner has complete privileges (code 0). 

2) The project members have read and execute privileges (code 5). 

3) All other users have no access privileges (code 7), 

The greatest protection a file can have is 7, and the least is 0. Usually the owner's field is or 1 . 
However, it is always possible for the owner of a file to change the access protection associated with 
the file even if the owner-protection is not set to 0. Thus codes and 1 are equivalent when they 
appear in the owner's field. Access protection can be changed by executing a RENAME UUO or by 
using the PROTECT monitor command as follows: 
PROTECT file.ext <nnn >) 

When an ENTER UUO specifies a protection code of 000 and the file does not exist, the monitor sub- 
stitutes the standard protection code as defined by the installation. The normal system standard is 
057. This protection prevents users in different projects from accessing another user's filesj however, 
a standard protection of 055 is recommended for in-house systems where privacy is not as important 
as the capcfcility of sharing files among projects. No program should be coded to assume knowledge 
of the standard protection. If it is necessary to use this standard, it should be obtained through the 
GETTAB UUO. 

To preserve files with LOGOUT, a protection code of 1 in the owner's field should be associated with 
the files. LOGOUT preserves all files in a UFD for which the protection code for the owner is greater 
than zero. The PRESERVE monitor command can be used to obtain a protection code of 1 in the owner's 
field. 



6.2.3. 1 UFD and SFD Privileges - The protection code associated with each file completely describes 
the access rights to that file independently of the protection code of the UFD. UFDs and SFDs may be 
read in the same manner as files but cannot be written explicitly, because they contain RIB pointers to 
particular disk blocks. For UFD and SFD privileges, users are divided into the same three categories 
as for files. Each category has three independent bits: 



Bit 

4 
2 
1 



Access Privileges 

Allow LOOKUPS in UFD or SFD. 

Allow CREATES in UFD or SFD. 

Allow the UFD or SFD to be read as a file. 
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The owner is permitted to control access to his own UFD and SFD. It is always legal for the owner to 
issue a RENAME to change the protection of his directories. Any program can create or delete SFDs; 
however, only privileged programs are allowed to create, supersede, or delete a UFD. The monitor 
checks for the following types of privileged programs: 

a. Jobs logged in under project-programmer number El ,2] (FAILSAFE). 

b . Jobs running with the JACCT bit set in JBTSTS (LOGIN , LOGOUT) . 
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Privileged programs are allowed to: 

a. Create UFDs (and SFDs). 

b. Delete UFDs (and SFDs). 

c . Set privileged LOOKUP, ENTER, and RENAME arguments. 

d. Ignore file protection codes. 

UFD and SFD privileges are similar with the exception being that SFDs can be RENAMEd and deleted 

by both privileged programs and the owner of the SFD if his protection byte is 7. 

6.2.4 Disk Quotas 

Each project-programmer number in each file structure is associated with two quotas that limit the 

number of blocks that can be stored under the UFD in the particular file structure. The quotas are: 

a . Logged-in quota . 

b . Logged-out quota . 

When the user logs in, he automatically starts using his logged-in quota. Because this is not a 
guaranteed amount of space, the user competes with other users for it. The logged-out quota is the 
amount of space that the user must be within in order to log off the system. Normally, the logged-out 
quota is less than or equal to the logged-in quota, so that the user must delete temporary files. 

If a user exceeds his logged-in quota, the monitor types the following message: 
[EXCEEDING QUOTA ON fs] 

where fs is theiname of the file structure. The message appears in square brackets (like the TECO core 
expansion message) to suggest a warning rather than an error. Unlike most monitor messages, this 
message indicates that the user program may continue to run, and the console remains in user mode. 
The user program can no longer create or supersede files (ENTER gives an error return) . Files already 
ENTERed are allowed to continue for a specified number of blocks. This amount is called the over^ 
drawn amount and is a parameter of the file structure. The overdrawn amount specifies the number of 
blocks by which the logged-in UFD may exceed its logged-in quota. When the user exceeds the over- 
drawn amount, the lO.BKT bit is set, and further OUTPUTs are not allowed. A CLOSE operates suc- 
cessfully, including the writing of the last buffers, and the RIBs. 

When the user logs in, the LOGIN program reads the logged-in quota from the file AUXACC.SYS for 
all public file structures in which the user is allowed to have a UFD. This information is passed to the 
monitor where it is kept in core. If the quota has changed since the user logged in last, LOGIN up- 
dates (or creates) the RIB of each UFD with the new quotas. 



^ Quota checking depends on FTDQTA which is normally off in the DECsystem-1040. 
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6.2.5 Simultaneous Access 

In its core area, the monitor maintains two four-word blocks called access blocks . These blocks control 
simultaneous access to a single file by a number of user channels. All active files have access blocks 
fhat contain file status information . Tlie access blocks ensure that a maximum of one user channel 
supersedes or updates a given file at a given time. 

6.2.6 File Structure Names 

Each file structure has a SIXBIT name specified by the operator at system initialization time. Tliis name 
[ can consist of four or less alphanumeric characters and must not duplicate any device, unit, or existing 
file structure name or its abbreviation. The recommended names for the file structures in the public 
pool are DSKA, DSKB, . . . , DSKN (in order of decreasing speed) . 

When a specific file structure is INITed (e.g., DSKA), LOOKUP and ENTER scorches are restricted 
to that file structure. Usually a channel is INITed with the generic name DSK, In which case all file 
structures in the active search list of the job are searched (refer to Paragraph 6.2.7). 

6.2.6.1 Logical Unit Names -When a single file structure name is specified, the set of all ilie units 
in that file structure is implied; however, it is possible to specify a particular logical unit within a 
file structure (e.g., DSKAO, DSKAl , DSKA2 are three logical units in the file structure DSKA)„ The 
monitor deals with file structures rather than with individual units; therefore, when reading files, 
specifying a logical unit within a file structure is equivalent to specifying the file structure itself. The 
monitor locates the file regardless of which unit it is on within a file structure. However, in writing a 
file, the monitor uses the logical unit name as a guide in allocating space and will, if possible, write 
the file on the unit specified. In this way, a user can apportion files among different units for increased 
throughput. 

6.2.6.2 Physical Controller Class Names - In addition to DSK, single file structure names (DSKA), 
and logical unit names (DSKAO), it is possible to specify a class of controllers. If the system has one 
controller of the type specified, the result is the same as if the user had specified the physical control- 
ler name. The controller classes supported by DEC are: 

DR (future drum) , FH, DP 

6.2.6.3 Physical Controller Names - It is possible to specify any of the units on a particular con- 
holler. TTie monitor relates tl-iat name to the file structures, which contain at leost one unit on the 
specified controller. More than one file structure may be specified when a physical controller name 
is used. TTie controllers that DEC supports are: 

DRA, DRB (future drum), FHA, FHB, DPA, DPB 

6.2 .6.4 Physical Unit Names - When a physical controller name is specified, all units on that con- 
troller are implied. It is possible to specify a physical unit name on a particular controller. The 
physical unit names that DEC supports are: 
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DRAO, DRBO Reserved for future drum (RXIO) . 

FHAO, . . . , FHA3 Mixture of Burroughs fixed-head disks (RD10) 

and Bryant drums (RM10B) on RCIO control . 

FHBO, . . . , FHB3 Mixture of Burroughs fixed-head disks (RD10) 

and Bryant drums (RMIOB) on second RCIO 
control . 

DPAO, . . . , DPA7 Mixture of RP02 and RP03 disk pocks on RP10 

control . 

DPBO, . . . , DPB7 Mixture of RP02 and RP03 disk packs on second 

RPIO control. 



6.2.6.5 Unit Selection on Output - If the user specifies a file structure name on an ENTER, the 
monitor chooses the emptiest unit on the file structure which does not currently have an open file 
(UFD's are not considered opened) for the job. This selection improves disk throughput by distributing 
files for a particular job on different units. For example, in a MACRO assembly with two output files 
and one input file, it is probable that the monitor would allocate the output files on units separate 
from each other and from the input file. If this were the only job running, there would be almost no 
seeks. Therefore, to take advantage of this, programs should LOOKUP input files before ENTERing 
output files. 

6.2.6.6 Abbreviations - Abbreviations may be used as arguments to the ASSIGN command and the 
INIT and OPEN UUOs. The abbreviation is checked for a first match when the ASSIGN, INIT, or 
OPEN is executed. The file structure or device eventually represented by the particular abbreviation 
depends on whether a LOOKUP or ENTER follows. A LOOKUP applies to as wide a class of units as 
possible, whereas an ENTER applies to a restricted set to allow files to be written on particular units 
at the user's option. For example, consider the following configuration: 

File Structure Physical Unit 

DSKA = FHAO, FHA1, FHA2 

DKSB = FHBO, FHBl 

DSKC = DPAO, DPAl, DPA2, DPA3 

DSKD = DPBO, DPBl, DPB2 

PRVA = DPB3 

Table 6-5 shows the file structures and units implied by the various names and abbreviations. 
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Table 6-5 
File Structure Names 



Argument Supplied to 
ASSIGN, MOUNT, INIT, OPEN 


File Structures or Units Implied 


LOOKUP 


ENTER 


D, DS, PSK 


Generic DSK according to 


job search 




list (refer to Paragraph 6.2.7) 


P, PR, PRV, PRVA 


DPB3 


DPB3 


F, FH, FHA 


DSKA, DSKB 


FHAO 


FHB 


DSKB 


FHBO 


FHAO 


DSKA 


FHAO 


FHBO 


DKSB 


FHBO 


DP 


DKSC, DSKD, PRVA^ 


DSKC 


DPA 


DSKC 


DSKC 


DPB 


DSKD, PRVA"*" 


DSKD 


DPAO 


DSKC 


DPAO 


DPB2 


DSKD 


DPB2 


DPB3 


PRVA 


PRVA 


Only if user has done a MOUNT. 





6.2.7 Job Search List 

To a user, a file structure is like a device; rtiat is, a file structure or a set of file structures may be 
specified by an INIT or OPEN UUO or by the first argument of the ASSIGN or MOUNT command. A 
console user specifies a file sfructure by naming the file structure and following it with a colon. 

There is a flexible naming scheme that applies to file structures; however, most user programs INIT 
device DSK, which selects the appropriate file structure, unless directed to do otherwise by the user. 
The appropriate file structure is determined by a job search list. A job search list is divided into two 
parts: 

a. an active search list (usually referred to as the job search list), and 

b. a passive search list. 

The active search list is an ordered list of the file structures that are to be searched on a LOOKUP or 
ENTER v^en device DSK is used. The passive search list is an unordered list of file structures main- 
tained by the monitor for LOGOUT time. At this time, LOGOUT requires that the total allocated 
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blocks on each UFD in bolfi the active and passive search lists be below the logged-out quota. Each 
job has its own active search list (established by LOGIN) with file structures in the order that they 
appear in rfie administrative conlrol file AUXACC.SYS. Thus, a user has a UFD for his project- 
programmer number in each file structure in which LOGIN allows him to have files. With the MOUNT 
command, mounted file structures may be added to the active search list. The following is an example 
of a search list: 

DSKB, DSKA, FENCE, DSKC 

DSKB and DSKA comprise the active search list. These file structures are represented by generic name 
DSK for this job. DSKC is the name of a file structure that was previously in the active search list. 
FENCE represents the boundary between the active and passive search list. 

Each file structure in a job search list may be modified by setting one of two flags with the 
JOBSTRUUO: 

a . Do not create in this structure if just generic DSK is specified . 

b. Do not write in this structure. 

Setting the "do not create" flag indicates that no new files are to be created on this file structure un- 
less explicitly stated. For example: if the "don't create" flag is set 

DSKA: FOO - 
allows FOO to be created on DSKA, but 

DSK: FOO - 
does not. For LOOKUPs on device DSK, the monitor searches the structures in the order specified by 
the job search list. For ENTERs when the filename does not exist (creating, see below), the file is 
placed on the first file structure in the search list that has space and does not have the "do not create" 
flag set. For ENTERs when the filename already exists on any file structure in the search list (super- 
seding, see below), the file is placed on the same structure that contains the older file. If the write- 
lock bit is set for the file structure, a write-lock en-or (ERWLK%) is given on the supersede. Because 
superseding is treated differently from creating, a user may explicitly place a file on a particular file 
structure, for example, a fast one with the do not create bit set, so that subsequent supersedes will re- 
main on that file structure even though generic DSK is used. 

6 .2 .8 User Programming 

Three types of writing on the disk may be distinguished. If a user does an ENTER with a filename 
which did not previously exist in his UFD, he is said to be creating that file. If the filename previous- 
ly existed in his UFD, he is said to be superseding that file; the old version of the file stays on the disk 
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(and is available to anyone who wants to read it) until the user does the output CLOSE. At the time 
of the CLOSE, the user's UFD Is changed to point to the new version of the file and the old version is 
elih&r deleted immediately or marked for deletion later if someone is currently reading it; the space 
occupied by deleted files is always reclaimed in the SAT tables (refer to Paragraph 6.2 .2.2) . Finally, 
if a user does a LOOKUP followed by an ENTER (the order is important) on the same filename on the 
same user channel , he will be able to modify selected blocks of that file, using USETO and USETI 
UUOs (refer to Paragraph 6.2.9.2) without creating an entirely new version; this third type of writing, 
called updating , eliminates the need to copy a file when making a small number of changes. A 
LOOKUP followed by an ENTER and OUTPUT (in that order) writes the output at the beginning of the 
file. To append information to the file, a USETI -1 is used before the OUTPUT. 

As a standard practice, user programs should read, create, and supersede (new file wirti same filename) 
files on different user channels. However, for compatibility wirii DECtapes, it is possible to read and 
create, or read and supersede, two files on the same user channel as long as all OUTPUTs and the 
CLOSE output are done before the LOOKUP and the first input, or vice versa . In other words, a 
CLOSE UUO is required between successive LOOKUPs and ENTERs unless updating is intended. 

The actual file structure of the disk is generally transparent to the user. In programming for I/O on 
the disk, a format analogous to that of DECtapes is used; that is, the user assumes a four-word directory 
entry similar in form to the first four words of retrieval information. The UUO format is approximately 
the same as for DECtapes: 

UUO D,E 

where UUO is an I/O programmed operator, and D specifies the user channel associated with this 
device. E points either to a four-word directory entry or an extended argument block in the user's 
program . 

6 .2 .8 . 1 Four-Word Arguments for LOOKUP, ENTER, RENAME UUOs - The four-word argument 
block has the following format: 



E 
E + l 

E + 2 
E+3 



name: 1 


pvT HIGH 
^^^ DATE 2 


DATE I 


PROT M TIME 


LOW 
DATE 2 


PROJECT 
NUMBER 


PROGRAMMER 
NUMBER 



OR 
E + 3 






ADR 



wh< 



NAME Is the filename in SIXBIT, or, if a UFD, is the project number in the 
left half and the programmer number in the right half. 



EXT is the filename extension in SIXBIT ASCII. 



6-26 



(continued on next page) 
June 1973 



-565- 

HIGH DATE 2 contains the high order 3 bits of the date on which the 
file was originally created (bits 18-20). 

DATE 1 is the date the file was last referenced (RENAME, ENTER, or 
INPUT) in the format of the DATE UUO (bits 21-35). 

PROT is the protection code for the file (bits 0-8). 

M is the data mode (ASCII, binary, dump) (bits 9-12). 

TIME is the time that the file was originally created, represented as 
the number of minutes past midnight of the creation date (bits 13-23). 

LOW DATE 2 is the low order 12 bits of the date (in the same format 
as the DATE UUO) on which the file was originally created (bits 24-35). 



NOTE 

The two-part format for DATE 2 (creation date) is used to maintain 
compatibility with monitors and media as old as 1964. 
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The programmed operators (UUOs) operate as follows: 

a. ENTER UUO - ENTER D, E causes the monitor to store the four-word directory en- 
try for later entry into the proper UFD or SFD when user channel D is closed or 
released. 



NAME 

EXT 

HIGH DATE 2 



DATE 1 



PROT 



M 



The filename must be nonzero; otherwise, an 
error return results. 

The filename extension may be zero; if so, the 
monitor leaves it as zero. 

If a nonzero date is obtained by concatenating 
the high order 3 bits in this field with the low 
order 12 bits in LOW DATE 2, then the monitor 
uses that value as the creation date for the file. 
If the date is zero, the monitor supplies the high 
order digits of the current date from the overflow 
inE + 2. 

The date may be zero, in which case the moni- 
tor substitutes the current date. The date must 
not be in the future; if this is so, the current 
date is used. 

If the protection code is 0, the monitor sub- 
stitutes the installation standard as specified 
at MONGEN time. If the protection code is 
and this ENTER is superseding a file, the 
protection of the new file is copied from the 
old file. RENAME may be used to change the 
protection after a file has been completely 
written and when it is being closed. 

The data mode is supplied by the monitor. It 
was set by the user in the last INIT or SETSTS 
UUO on channel D. 
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PROJECT NUMBER 
PROGRAMMER NUMBER 
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If these are 0, and bits 18-20 of E + 1 are zero 
the monitor supplies the current date and time 
as the creation date and time for the file. The 
high order digits of the creation date overflow 
to bits 18-20 of E + 1 (HIGH DATE 2). If 
either is nonzero, the monitor uses the HIGH 
DATE 2 supplied by the user in E + 1 and the 
TIME and LOW DATE 2 supplied in E + 2. 
Thus, files may be copied without changing 
the original creation time and date. 

If this word is 0, the file will be written in the 
default directory. (For example, if the default 
path is [10, 10, A], the file will be written in 
SFD A which is contained in [10, 10] .UFD.) 
The default path is determined by the PATH. 
UUO (refer to Paragraph 6.2.9.1). If a de- 
fault path has not been specified via the 
PATH. UUO, it is the job's UFD (i.e., the 
project-programmer number under which the 
user is logged in). 

If this word is a project-programmer number, 
the file will be written in the UFD specified 
(I.e., sub-directories will not be scanned). 
This allows the program to write in the disk 
area under which the job is logged in although 
the default directory is different. Note that 
it is generally not possible to create (ENTER) 
files in another user's area of the disk, be- 
cause UFDs are usually protected from ail but 
the owner when creating files. 

If this word is XWD 0, ADR, the file will be 
written according to the path specified by ADR. 
The argument block beginning at ADR is the 
same as in the PATH. UUO (refer to Paragraph 
6.2.9.1) except that the first two arguments 
(ADR and ADR + 1) are ignored. The scan 
switch (ADR + 1) is not needed since if the file 
is found in the specified directory, it will be 
superseded, and if not found, it will be created 
at the end of the path of the specified directory, 
even if a file with the same name appears in an 
upper-level directory. A path specification 
in the ENTER block overrides any default path 
specification given in the PATH. UUO. 



With certain types of error returns peculiar to the disk, the right half of E + 1 is 
set to a specific number to indicate the error that caused the return. For ex- 
ample, if the extension UFD is specified and bit 18 (RP.DIR) of the file status 
status word is not set, the right of E + 1 is set to 2 (protection failure). Refer 
to Paragraph 6.2.8.3 for a special note on error recovery. Refer to Appendix 
E for the error codes returned on the ENTER UUO. 
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When issuing a supersede ENTER (an ENTER after a LOOKUP on the same chan- 
nel), the user should check that locations E through E + 3 are as he desires. 

When an ENTER is executed by the monitor on a file that exists, a new file by 
that name is written, and those bits in the SAT blocks that correspond to the 
blocks of the old file are zeroed when the CLOSE (or RELEAS) UUO is executed 
provided that bit 30 of the CLOSE is (refer to Paragraph 4.7.7). Space is 
thereby retrieved and available to other users after the hew file has been success- 
fully written. If a file structure is INITed on channel D, the monitor maximizes 
the job's throughput by selecting the emptiest unit for which the job has no opiened 
files (refer to Paragraphs 6.2 .6 .5 and 6 .2 .6 .6) . 



b. LOOKUP UUO - LOOKUP D, E causes the monitor to read the appropriate UFD or 
SFD. If a later version of the file is being written, the old version pointed to by 
the UFD is read. 

NAME The same as on an ENTER. 

EXT The same as on an ENTER. 

DATE 1, PROT, M, These arguments are ignored. The monitor 

TIME, LOW and HIGH returns these quantities to the user in E + 1 
DATE 2 and E + 2. 

PROJECT NUMBER If this word is 0, the file will be read from 

PROGRAMMER NUMBER the user's default directory path. The entire 

path is searched only if the scan switch is set 
via the PATH . UUO (refer to Paragraph 
6.2.9.1). If a default path has not been 
specified, it is the project-programmer num- 
ber under which the user is logged in. If a 
project-programmer number is specified, 
the file will be read from the UFD specified 
(i.e., subdirectories will not be scanned). 
Thus, it is possible to read files in other 
user's directories, provided the file's pro- 
tection mask permits reading and the UFD 
permits LQOKUPs. If this word is XWD 0, 
ADR, the file will be read according to the 
path specified by ADR. The argument 
block beginning at ADR is the same as in 
the PATH . UUO except that the first argu- 
ment is ignored, and the second argument, 
if 0, uses the default value of the scan- 
ning switch (refer to the PATH. UUO). A 
path specification in the LOOKUP block 
overrides any default path specification 
given in the PATH. UUO. 
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The monitor returns the negative word count (or positive block count for files 
larger than 2^7 words) in the LH of E + 3, in RH of E + 3 when the four-word 
argument block is given. As a result, the monitor treats a negative project- 
programmer number as if it were 0, however, this will not always be true; 
therefore, programs must be written to either clear E + 3 before doing a 
LOOKUP, ENTER, or RENAME cm- set E + 3 to the desired project-programmer 
number. In the future, a negative project-programmer number may be used 
to indicate SIXBIT alphabetic characters for project and programmer initials. 

The numbers placed in the RH of E + 1 on an error return have a significance 
analogous to that described for the ENTER UUO (refer to Appendix E). 

If the file is currently being superseded, the old file is used. 

c. RENAME UUO - RENAME D, E is used to alter the filename, the filename ex- 
tension and/or protection of a file, or to delete a file from the disk. This UUO 
can be used to change the name of an SFD, but an attempt to change the exten- 
sion or project-programmer number associated with an SFD, the name, ex- 
tension, or project-programmer number associated with a UFD, or the project- 
programmer number of a device with an implied project-programmer number 
(e.g., SYS:, NEW:, OLD:) results in a protection error. To RENAME a file, 
a LOOKUP or ENTER must first be done to identify the file for the RENAME 
UUO . Locations E through E + 2 are as described for ENTER . If E + 3 = 0, there 
is no change in the directory of the file. If E + 3 is the default project-programmer 
number, the file is renamed in that UFD. If E + 3 has a different project-programmer 
number than the one in which the file is LOOKUPed or ENTERed (i.e.,, E + 3 
is not the default project-programmer number), the monitor deletes the directory 
entry from the old directory (UFD or SFD) and inserts the directory entry into the 
specified UFD, provided the user has the privileges to delete files from the old 
directory, and to create files in the new UFD. (This is an efficient way to move 
a file from one UFD to another, since no I/O needs to be done on the data blocks 
of the file.) If E + 3 = XWD 0, ADR, the file is renamed into a new SFD or UFD 
according to the path specified by ADR . (Refer to the PATH . UUO. ) Therefore, 
the only way to RENAME a file into a SFD different from the one which it is in 
to give an explicit path via an argument block. 

A CLOSE is optional because RENAME performs a CLOSE. However, a 
CLOSE should not be issued between a LOOKUP and RENAME if the file is 
not in the default path or cannot be obtained from the default path by scan- 
ning because CLOSE erases all memory of the path of a file. If a CLOSE is 
performed and the file is not in the default path, the RENAME returns the FILE 
NOT FOUND error. In addition, disk accesses are minimized if a CLOSE 
does not precede a RENAME. 

RENAME enters the information specified in E through E + 2 into the retrieval 
information and proper directory. If the contents of E is zero, RENAME has 
the effect of deleting the file. Although only a privileged job can delete a 
UFD, any job can delete an SFD. If the directory is not empty or if a job is 
currently using the directory, the RENAME returns the DIRECTORY NOT 
EMPTY error. (Refer to Appendix E for the error codes.) Refer to Paragraph 
6.2.8.3 for a special note on error recovery. 



6-30 June 1973 



-569- MONITOR CALLS 

When issuing a RENAME UUO, the user must ensure that the status at locations 
E through E + 3 are as he desires. An ENTER or LOOKUP must have preceded the 
RENAME; therefore, the contents of E through E + 3 will have been altered, or 
filled if the E is the same for all UUOs. 

Examples - The sample code below can be used to assemble the 15-bit creation 
date of a disk (or DEOape) file in register Tl after a successful LOOKUP. The 
four-word argument block begins at location E. 

LDB Tl, [POINT 12, E+2, 35] ;GET LOW-ORDER PART 

LDB T2, [POINT 3, E+1, 20] ;GET HIGH-ORDER PART 

DPB T2, [POINT 3, Tl, 23] ;MERGE THE TWO PARTS 

The following sample code illustrates setting the 15-bit creation date in the 
four-word ENTER argument block from the value in register Tl. 

DPS Tl, [POINT 12, E+2, 35] ;STORE LOW-ORDER PART 

ROT Tl,-tD12 ;POSITION HIGH PART 

DPS Tl, [POINT 3, E+1, 20] ;STORE HIGH-ORDER PART 
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6.2.8.2 Extended Arguments for LOOKUP, ENTER, RENAME UUOs - A number of quhntities have 
been added to the existing four-word block. The user program may specify exactly the ibumber of 
words in the argument block . If the left half of E is and the right half of E is three orjgreater, the 
right half of E is interpreted as the count of the number of words which follow. If the ribht half of 
E is less than three, a file-not-found return is given because the user program is not supj^lying enough 
arguments. Allowed arguments supplied by the user program are returned by the monitor as values. 
If the user program supplies arguments that are not allowed, the monitor ignores these arjguments and 
supplies values on return . Table 6-6 indicates the arguments that may be supplied by a 'user program . 



Table 6-6 
Extended LOOKUP, ENTER, and RENAME Arguments 



Re I. Loc 



Symbol 



Lookup 



Create 
Supers 



Update 
Rename 



Arguments and Value 



6 

7 

10 

11 



.RBCNT 
.RBPPN 

.RBNAM 
.RBEXT 



RBPRV 



.RBSIZ 

.RBVER 
.RBSPL 
.RBEST 
.RBALC 



A 
AO 



V 
V 
V 
V 

V 

V 
V 
V 
V 



A 
AO 



A 
AO 



AO 
V 
AO 
AO 



A 
A 
A 
A 



A 
AO 



A 
A 



A 
A 
A 
A 



A 
A 
A 
A 



Count of arguments following 

Directory name (project-programmer no.) or 
pointer 

Filename in SIXBIT 

File extension (LH) 

High order 3 bits of 15-bit creajtion date 

(bits 18-20) 

Access date (bits 21-35) 

Privilege (bits 0-8) 

Mode (bits 9-12) 

Creation time (bits 13-23) 

Low order 12 bits of 15-bit cre4tion date 

(bits 24-35) I 

Length of file in data words wrijtten 
(+no. words) \ 

Octal version number (36 bits) 

Filename to be used in output sbooling. 

Estimated length of file (+ no. 1|) locks) 

Highest relative block number \|vithin the file 



allocated by user or monitor to 



file. 



A = Argument (supplied by privileged or nonprivileged user program) and returned b;i' monitor as 
a value. 

AO = Argument like A with the addition that a argument causes the monitor to substitute a 
default value. 

V = Value (returned by monitor) cannot be set even by privileged program, monitor ignores 
argument. 

Al = Argument if privileged program (ignored if nonprivileged). 



6-31 



(continuecj on next page) 
June 1973 



MONITOR CALLS 



-572- 

Table 6-6 (Cont) 
Extended LOOKUP, ENTER, and RENAME Arguments 



Rel . Loc 


Symbol 


Lookup 


Create 
Supers 


Update 
Rename 


Arguments and Value 


12 


.RBPOS 


V 


A 


A 


Logical block no. of first block to allocate 
within F.S. 


13 


.RBFTl 


V 


A. 


A 


Future nonprivileged argument - reserved 
for DEC 


14 


.RBNCA 


V 


A 


A 


Nonprivileged argument reserved for 
customer to define 


15 


.RBMTA 


V 


Al 


Al 


Tape label if on backup tape 


16 


•RBDEV 


V 


V 


V 


Logical unit name on which the file is located 


17 


.RB.STS 


V 


Al 


Al 


1) LH=Combined status of all files in UFD 

2) RH=Status of this file 


20 


.RBELB 


V 


V 


V 


Bad logical block within error unit 


21 


.RBEUN 


V 
V 


V 
V 


V 
V 


1) LH=Logical unit no. within F.S. of bad 

unit(0,,,N). 

2) RH=No. of consecutive blocks in bad 

region 


22 


.RBQTF 


V 


Al 


Al 


(UFD-only) FCFS logged-in quota in blocks 


23 


.RBQTO 


V 


Al 


Al 


(UFD-only) logged-out quota in blocks 


24 


.RBQTR 


V 


Al 


Al 


(UFD-only) reserved logged-in quota 


25 


.RBUSD 


V 


Al 


Al 


(UFD-only) no. of blocks used at last 
logout 


26 


.RBAUT 


V 


Al 


Al 


Author project -programmer number (creator 
or superseder) 


27 


.RBNXT 


V 


Al 


Al 


Next file structure name if file continued 


30 
31 


.RBPRD 
.RBPCA 


V 
V 


Al 
Al 


Al 
Al 


Predecessor file structure name if file con- 
tinued 

Privileged argument word reserved for each 
customer to define as he wishes 


32 


.RBUFD 


V 


V 


V 


Logical block number within F.S. (not 
cluster no.) of the RIB of the UFD in which 
the name of this file appears 


33 


.RBFLR 


V 


V 


V 


Relative block number in file of first block 
in RIB 


34 


.RBXRA 


V 


V 


V 


Extended RIB address 


35 


.RBTIM 


V 


V 


V 


Creation date in universal date-time standard 
(refer to Paragraph 3.6) 


A = Argun 
a vail 


lent (suppli 
je. 


ed by privi 


eged or 


lonprivileg 


ed user program) and returned by monitor as 


AO = Argu 
defa 


ment like / 
ult value. 


V with the c 


iddition t 


hat a org 


ument causes the monitor to substitute a 


V= Value 
argum 


(returned 1 
ent. 


>y monitor) 


cannot b 


e set even 


by privileged program, monitor ignores 


Al = Argu 


ment if pri\ 
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jram (ign 


ored if non 


privileged). 
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Vne following explanation is a more complete description of the terms used in Table 6-6. 

• RBPPN LH=octal project number (right-justified). 

RH=octal programmer number. 
The project-programmer number is of the UFD in which the file is to be 

LOOKedUP, ENTERed, or RENAMEd. To LOOKUP the MFD, .RBPPN 
must contain a 1 in the left half and a 1 in the right half indicating that 
the filename (.RBNAM) is to be LOOKedUP in project 1 , programmer Ts 
UFD (the MFD). 

.RBNAM SIXBIT filename, left justified with trailing nulls. If the MFD or UFD 

is being LOOKedUP, ENTERed, or RENAMEd, this location contains 
the project-programmer number. If a SFD is being LOOKedUP, 
ENTERed, or RENAMEd, this location contains the directory name. 
The argument can be only on a RENAME, in which case the file is 
deleted. If the filename is not left justified pn ENTER, most programs 
are unsuccessful on a subsequent LOOKUP. The monitor cannot left- 
justify the argument because it may be an octal project-programmer 
number. 

.RBEXT LH=SIXBIT filename extension, left justified with trailing nulls. Null 

extensions are discouraged because they convey no information. If the 
extension is not | eft justified on ENTER, most programs are unsuccessful 
on a subsequent LOOKUP. RH, bits 18-20 = high order 3 bits of 15-bit 
creation date/ bits 21-35=access date in standard format. If an error 
return is given, bits 18-35 are set to an error code by the monitor before 
the error (no skip) return is taken. Refer to Paragraph 6.2.8.3 for a 
special note on error recovery. 

.RBPRV Bits 0-8=protection codes. (RB.PRV) 

Bits 9-12=data mode in which file is created. (RB.MOD) 
Bits 13-23=creation time in minutes since midnight. (RB.CRT) 
Bits 24-35=low order 12 bits of 15-bit creation date in standard format. 
(RB.CRD) 

. RBSIZ Written length of file . The word is the positive number of words written 

in the file. For extended arguments, this word is never used for project- 
programmer numbers. (The four-word block remains compatible so that 
LH = -number of words in file, RH=0.) This argument is ignored, and a 
value is always returned. 

.RBVER Octal version number like the contents of location 137 in the job data area 

LH=patch level (A=l, B=2, etc.) 

Set by monitor except in the case of privileged programs. 

RH=octal version number, never converted to decimal . This argument 
is accepted, except on a LOOKUP. If a user program wishes to increase 
the version number by 1 on each UPDATE, it should add 1 to location 
E + 6 between the LOOKUP and the ENTER. 

.RBSPL Filename to be used to label the output on a device which is being 

spooled. The filename is taken from the ENTER to the device, or is 
if an ENTER was not done. 

.RBEST Estimated length of file in positive number of blocks. On an ENTER, 

FILSER uses this value as the number of blocks to allocate for the file. 
If the estimated number of blocks is too low, incremental allocation 
is done. 
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RBALC 



.RBPOS 



RBFTl 
RBNCA 
.RBMTA 



.RBDEV 
,RBSTS 



5.06 Monitor 



Number of 128-word blocks, N, to be allocated to the file after completion 
of ENTER or RENAME. This number includes the RIBs of the file, N is 
equivalent to last relative block of the file, 

A means do not charge allocation rather than deallocate all the blocks 
of the file. All of ihe data blocks can be deallocated by superseding the 
file and doing no outputs before the CLOSE. This argument can be used 
to allocate additional space onto the end of the file, deallocate pre- 
viously allocated but unwritten space, or truncate written data blocks. 

Tlie smallest unit of disk space that the monitor can allocate is a cluster 
of 128-word blocks. Typically small devices use a cluster size of 1 
block . If N is not the last block of a cluster, the monitor rounds up, 
thereby adding a few more blocks than the user requested. 

Logical block number, L, of the first block to be allocated for a new 
group of clusters appended to the file. A logical block number is 
specified with respect to the entire file structure. Logical block num- 
bers begin with logical block number 0. This feature combined with 
DSKCHR UUO allows a user program to allocate a file with respect to 
tracks and cylinders for maximum efficiency when the programi runs 
alone. Because SAT blocks, swapping space, and bad blocks are 
scattered throughout a file structure, programs using this feature 
must be prepared to handle such contingencies. It is discouraged for 
any programs to depend on blocks actually used for allocation to 
operate without errors. 

Future nonprivileged argument reserved for DEC. 

Nonprivileged argument reserved for customer definition. 

A 36-bit tape label if file has been put on magnetic tape. If allocated 
space is 0, Hien file was deleted from disk when it was copied on mag- 
netic tape. Argument is accepted only from privileged programs; other- 
wise, it is ignored. 

The logical name of the unit on which the file is located. Ignored as an 
argument, returned as a value. 

File status word 

LH=status of UFD. Bit 0=1 (RP.LOG) if the user is logged in and is set 
by LOGIN. LOGOUT clears this bit. 

RH=statusof file. 

Bit 18=1 (RP.DIR) if file is a directory file; needed to protect the system 
from a user wl»o might try to modify a directory file. The protection error 
is given if extension UFD is given on an ENTER or RENAME and 
this bit is not set. 

Bit 19=1 (RP.NDL) if file cannot be deleted, renamed, or superseded, 
even by a privileged program or by a user logged in under CI ,2] . 

Bit 21 = 1 (RP. NFS) if file should not be dumped by FAILSAFE because 
certain files are needed befcM-e FAILSAFE can run . 

Bit 22=1 (RP.ABC) if file always has bad checksum (because the monitor 
never recomputes the checksum) e.g., SWAP. SYS. SAT. SYS. 

Number of 128-word blocks, N, to be allocated to the file aflfer completion 
of ENTER or RENAME. This number includes the RIBs of the file. N is 
equivalent to last relative block of the file. 

(continued on next page) 
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.RBSTS (Cont) Bit 26=1 (RP.CMP) if UFD compressing. 

Bit 32=1 (RP.BFA) if file is bad because of a FAILSAFE 
restore. 

Bit 33=1 (RP.CRH) if file was closed after a crash. 

Bit 35=1 (RP.BDA) if file is bad because of damage 
assessment. 

The following bits appear in both the LH and RH of this location: 

Bit 11 (RP.URE) and bit 29 (RP.FRE) = 1 if any file in this UFD (or this 
file) hqS Iwd a hard data error while reqding. (The lO.DTE bit has been 
set.) An entry is made in the BAT block so that the bad region is not 
reused , 

Bit 10 (RP.UWE) and bit 28 (RP.FWE)= 1 if any file in this UFD (or this 
file) has had a hard data error while writing. (The lO.DTE bit has been 
set.) An entry is made in the BAT block so that the bad region is not 
reused. 

Bit 9 (RP.UCE) and bit 27 (Rf.FCE) = 1 if any file in this UFD (or this 
file) has Irad a software checksum error or redundancy check error. 
(The lO. IMP bit has been set.) 

NOTE 

Device errors (lO. PER) are not flagged in the file status 
word because they refer to a device and disappear when 
a device is fixed ^ 

.RBELB Logical block number wjthiri the unit on which last date error (lO.DTE) 

occurred, as opposed to block within file structure. Set by the monitor 
in ihe RIB on a CLOSE when the hardware detects either a hard bad 
parity error or two search errors while reading or writing the file. Device 
errors, checksum, and redundancy errors are not stored here. This argu- 
ment is ignored, and a value is returned. 

LH=logical unit number within file structure on which last bad region 
vyas detected. 

RH=*iumber of bad blocks in the last-detected bad region. The bad 
region may extend beyond the file. This argument is ignored, and a 
value is returned. 

RBQTF Meaningful for UFD only. Contains first-come-first-served I ogged-in 

quota. This. quota is the maximum number of data and RIB blocks that 
can be in rtiis directory in tbis structure while the user is logged in. 
The UFD and its RIB are not counted. Argument is ignored unless it is 
from q privileged program. 

.RBQTO Meaningful for UFD only. Contains logged-out quota . This quota is the 

maximum number, of data and RIB blocks that can be left in this directory 
in this file structure after the user logs of^^* LOGOUT requires the user 
to be bfjow this quota to log off. LOGIN stores these quotas in the RIB 
of ifie UFD> so that LOGOUT does not have to scan ACCT.SYS at 
LOGOUT time to find the quota. Argument is ignored unless it is from 
q privileged program. 
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.RBQTR 
.RBUSD 



RBAUT 



RBNXT 
RBPRD 
RBPCA 
RBUFD 

RBFLR 

.RBXRA 

RBTIM 
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Meaningful for UFD only. (Reserved for fhe future.) Contains reserved 
logged-in quota. This quota is the guaranteed number of blocks the user 
has when he logs in. Argument is ignored unless it is from a privileged 
program . 

Meaningful for UFD only. Contains number of data and RIB blocks used 
in this directory in this file structure by the user when he last logged off. 
LOGIN reads this word so that it does not have to LOOKUP all files 
in order to set up the number of blocks the user has written. LOGIN 
s'ets bit of the file status word (.RBSTS) and LOGOUT clears it in 
order to indicate whether LOGOUT has stored the quantity. Argument 
is ignored unless it is from a privileged program. 

Contains proi'ect-programmer number of the creator or superseder of the 
file, as opposed to owner of file. Usually the author and the owner are 
the same. Only when a file is created in a different directory are these 
different. This argument is used by Batch for validating queue entries in 
other directories. Argument is ignored unless it is from a privileged program. 

Reserved for future. 

Reserved for future. 

Privileged argument reserved for customer definition. 

The logical block number (not cluster number) in the file structure of the 
RIB of the UFD in which the name of this file appears. 

The relative block number of the file to which the first pointer of this RIB 
points. It is used for multiple RIBs (i.e., for prime RIB). 

The extended RIB address (logical unit number and cluster address of next 
RIB in a multiple-RIB file). 

The date and time of creation of the file in the universal date-time standard 
(refer to Paragraph 3.6 ). That is, the LH contains the date and the RH 
contains the time as a fraction of a day. 



6.2.8.3 Error Recovery for ENTER and RENAME UUOs - Error codes for the LOOKUP, ENTER, and 
RENAME UUOs are returned in the right half of location E + 1 of the four-word argument block and 
in the right half of location E + 3 (.RBEXT) in the extended argument block. This means that the 
error code overwrites the high order 3 bits of the creation date and the entire access date. Since the 
vast majority of programs recover from these errors either by aborting or by reinitializing the entire 
argument block, this overwriting of data does not cause any problems. However, a small number of 
programs may attempt recovery by fixing just the incorrect part of the argument block and then re- 
trying the UUO. These programs should always restore the right half of location E + 1 before retrying 
an ENTER or a RENAME UUO. (In order to eliminate problems for programs recovering from errors 
for files with zero creation dates, which is the most common case, error codes are restricted to a 
maximum of 15 bits even though the entire right half of E + 1 is used. In addition, the 5.06B and 
later monitors force access dotes to be greater than or equal to the creation date, but never greater 
than the current date.) 
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6.2.9 Special Programmecj Operator Service 

The following are special programmed operator service UUOs. 

6.2.9. 1 PATH. AC, or CALL! AC, 1 10^ - This UUO sets or reads the default directory path, or reads 
the current directory path on a channel. The call ist 

MOVE AC, CXWD n, ADR] 
PATH. AC, 
error return 
normal return 

ADR: org 

scan switch 
ppn 

SFD, name 
SFDj name 

ADR+n-1: 

The first word of the argument block contains one of the following: 

C (ADR) = SIXBIT device name, or XWD 0, D^ 

Return the current path for the specified device or channel D. 
C (ADR) = XWD JOB, -1 

Return the default directory path. 

C (ADR) = -2 

Define the default directory path. 
C (ADR) = -3 

Define the additional path to be searched when a file is not found in the user's 
directory path. 

C (ADR) =XWD JOB, -4 

Return the additional path to be searched when a file is not found in the user's 
directory path. 



This UUO depends on FTSFD which is normally off in the DECsystem-1040. 

Note fhat this function of the PATH. UUO is available even if FTSFD is turned off. 
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If the left half of ADR is a iob number N and the right half of ADR is -1 or -4, the returned values are 

for either 

1) iob N if 0<M< the highest legal iob number, or 

2) the current iob if N is outside the above range (i.e., N< or N >the highest legal 
iob number). 

When defining a path within a UFD (C(ADR) = -2), ,ADR+1 is the scan switch, ADR+2 is the default 
proiect -programmer number, and the remainder of the argument block up to the first zero word defines 
the default path. The scan switch determines whether or not the monitor scans for the file on a LOOKUP. 
If the switch is 1, the monitor examines the specified directory only; higher level directories are not 
searched. If the switch is 2, the following occurs: 

1) The monitor searches the UFD or SFD specified by the path (either explicit 
or default path). If the file is found, the scan is terminated. 

2) If the file Is not found, the monitor backs up one directory along the path and continues 
the scan (i.e., it scans the directory in which the current SFD appears). The scan is 
terminated when the UFD is searched or when the file is found. 

Scanning allows directories to be nested since any file not found in the current SFD is obtained auto- 
matically from a higher level directory. This is useful when a user has a default directory in use con- 
taining files he is currently working on and a higher level directory containing xhecked-out routines. 
Since SFDs are continued across file structures but the depth of the nesting of directories is not neces- 
sarily the same on each file structure, each scan searches the file structures that are 1) in the iob's 
search list and 2) have SFDs to the depth specified in the path. The file structures are searched in the 
same order as they appear in the search list. 

On an ENTER, the scan switch is Ignored; if the file is found in the specified directory, it will be 
superseded. If the file is not found, it will be created at the end of the path in the specified directory 
whether or not a file with the same name appears in a higher level directory. 

When defining the additional path to be used after the user's directory path is searched (C(ADR) = -3), 
ADR+1 indicates if SYS (bit 35 = 1) or experimental SYS (bit 34 = 1) is to be scanned, and ADR+2 is 
the proiect -programmer number to be used for a user library. These locations are used as follows. If 
the file is not found in the user's directory path on a LOOKUP DSK:, the directory specified in 
ADR+2 is searched for the file. This directory must be a UFD and allows users with different directory 
paths to share a common directory of files. If the file is not found in the library and if bit 35 of 
ADR+1 is set, the system library (SYS5[1,4]) Is searched. In addition on a LOOKUP SYS:, if bit 34 
of ADR+1 is set, the directory area [1,53 is searched before the system library area [1,4] . The [1,5] 
area is called the experimental SYS area (NEW:) and can be used to separate software that is near the 
end of the development and testing stages from the standard system software on the system library [1,4]. 

When returning a path, ADR+1 contains the following: 

I bits 34 and 35 ^^^e scan switch ^ 

bit 33=1 if experimental SYS (NEW:) is searched 

bit 32=1 if SYS is searched 

bit 31=1 if there is a user librcry 

(continued on next page) 
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bif 30=1 if the user-supplied project -programmer number is to b© 

ignored on a LOOKUP or ENTER UUO and the implied 
project-programmer number of the device is to be used 
(e.g., [1,4] if SYS; [1,5] if NEW). The implied project- 
programmer number is returned in ADR +2. 

bits 27-29 the type of search list: 

a non-standard search list (e.g., DSKA) 

1 job search list 

2 ALL search list 

3 SYS search list 

and ADR+2 through ADR-hi-1 is the path. If the path is less than n-1 words, a zero word is stored at 
the end. If ADR contains a device name or channel number when the UUO is called, the file structure 
I name or ersatz device name is returned in ADR depending on the name specified (e.g., SYS is 

returned only if C(ADR) = SYS and the fob does not have a device with the logical name SYS). If a 
LOOKUP or ENTER has been done on the specified device or channel number, the following is 
returned in the argument block: 

ADR: the SIXBIT name of the file structure or ersatz device 



ADR+1 
ADR+2 
ADR+3 



the scan switch. 

the actual project-programmer number associated with the file. 

the actual path of the file. 



ADR+m: the end of the path if m <n-l . 

If no LOOKUP or ENTER has been done, the following is returned: 

I ADR: SIXBIT DSK or ersatz device name. 

ADR+1: the scan switch. 

ADR+2: the job's default project -programmer number (or the project- 

I programmer number of the ersatz device). 

ADR+3: the default path to the file. 

ADR+m: the end of the path if m <h-l 

On an error return, 

AC is. unchanged if the UUO is not implemented. (SFD remains a reserved extension, 
but all SFD code disappears.) The GETTAB which returns the maximum number of 
SFDs allowed returns or fails. The default path is the user's proi'ect -programmer 
number. 

AC is if the device or channel number does not represent a disk. 

AC is -1 if a SFD in the path specification is not found. 



(continued on next page) 
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1) This example sets the default path to [27, 235, SUB] with no scanning in effect. 

MOVE 1 , CXWD 5, A] 

PATH. ], 

error 

normal 

A: -2 
1 

27, 235 
SUB 


2) Refer to Figure 6-6. The path plus filename for file A is X.MAC [10,633 . The 
path plus filename for file B is Y.CBL [14,5] . The path plus filename for file C 
is Z.ALG [14,5, M]. 

3) Refer to Figure 6-7. The job's search list is DSKA/N, DSKB, DSKC and the default 
path is [PPN, A, B, C, D]. 

A) LOOKUP DSK: with no matches scans in order: DSKA:D (.SFD), DSKArC, 
DSKB:C, DSKA:B, DSKB:B, DSKA:A, DSKB:A, DSKAtPPN (.UFD), DSKB:PPN 
DSKCrPPN. 

B) LOOKUP DSK: FILE2 finds DSKA: FILE2 [PPN, A, B, C] . 

(continued on next page) 
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Z-ALG 



Figure 6-6 Directory Paths on a Single File Structure 



DSKA: [1,1].UFD 



dska:ppn.ufd 



FILE 1 A.SFD 



FILE 2 FILE 3 B.SFD 



FILE 2 D.SFD 



FILE 4 



(FILE 1) 



DSKB:[1,1].UFD 



DSKB: PPN. UFD 



r—~-2 



B.SFD FILE 6 



C.SFD D.SFD 



(FILE 



3 



DSKC;[1,13.UFD 



DSKC-. PPN. UFD 



FILE 1 B.SFD FILE 5 



Figure 6-7 Directory Paths on Multiple File Structures 
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C) LOOKUP DSKB: FILE2, or LOOKUP DSKC: FILE2 fails. 

D) ENTER DSK: FILE9 receives an error since no file structure has both the 
no-create bit off and the directory structure [PPN, A, B, C, D] . 

E) ENTER DSKA: FILET creates the file at the end of the path on DSKA (the 
file designoted by (FILE 1) in diagram). 

If the default path is [PPN, A, B, C]: 

A) ENTER DSK: FILE6 creates DSKB: FILE6 [PPN, A, B, C] (the file desig- 
nated by (FILE6) in diagram). 

B) ENTER DSK: FILE2 supersedes FILE2 in DSKA: [PPN, A, B, C] 

C) LOOKUP DSK: FILE4 fails. 

D) ENTER DSK: FILE7 supersedes FILE7 in DSKB: [PPN, A, B, C3 . 

4) The user defines the following path. 

MOVE 1, [XWD 5, A] 

PATH. 1, 

error 

MOVE 1, [XWD3,B] 

PATH. 1, 

error 

A: -2 Define the default directory path 

2 Scanning is in effect 
10,63 The UFD [10,63] 
NAME The SFD [NAME] 

The default path is [10,63, NAME] 

B: -3 Define an additional path. 

3 Both experimental SYS and SYS are searched. 
10,7 The user library is [10,7] 

If the user is logged in as [10,10] and does a LOOKUP DSK: FILTST, the following directories are 
searched in order: 

[NAME. SFD] 1 

[10,63. UFD] f iob's search list. 

[10,7. UFD] ) 

[1,5. UFD] ) system's search list. 

[1,4. UFD] / 

If the user is logged in as [10,10] and does a LOOKUP DSK: PRJFIL [10,155], the following direc- 
tories are searched: 

[10,155. UFD] \ 

[10,7. UFD] / iob's search list 

[1,5. UFD] J 

[1,4. UFD] / system's search list 

6.2.9.2 USETI and USETO UUOs - The function of these UUOs is to notify the disk service routines 
that a particular relative block (instead of the next block in sequence) is to be used on the following 
INPUT or OUTPUT on the specified channel. USETI and USETO do not perform I/O; they simply 
change the current position of the file. Note that each INPUT or OUTPUT also logically advances 
the file; therefore, to reread or rewrite the same block a USETI (or USETO) must be given before each 
INPUT (or OUTPUT). 
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Since the monitor reads (writes) as many buffers as it can on INPUT (OUTPUT), it is difficult to 
determine which buffer the monitor is processing when the USETI (USETO) is given. Thus, the INPUT 
(OUTPUT) following the USETI (USETO) may not read (write) the buffer containing the block specified 
with the USETI (USETO). However, a single buffer ring reads (writes) the desired block since the de- 
vice must stop after each INPUT (OUTPUT). Alternatively, if bit 30 of the status word (lO.SYN) is 
set via an INIT, OPEN, or SETSTS UUO, the device stops after each bufferful of data on an INPUT 
(OUTPUT) so that the USETI (USETO) will apply to the buffer supplied on the next INPUT (OUTPUt). 
The calls are: 

USETI D,N and USETO D,N 

where D is the channel number, and N designates a block relative to the beginning of the file. N can 
be in the following ranges: 



N Block Represented 

1 -777777^ Blocks of f he f i le 

o 
Prime (1st) RIB 

-2, , -IOq Extended (2nd to the 8th) RIB 

o 

-1 Last block accessed (USETO) or end of file (USETI). 

Note that the 18-bit effective address used for N is interpreted as both an unsigned positive integer and 
a signed (2's complement) integer. This H required since, with extended RIBs, there can be more than 
277777 a (largest positive signed integer) blocks in a file. The exact interpretation of N depends upon 
the context of the USETI/USETO (i.e., reading, writing, updating). 

When reading or writing a file, USETI precedes an INPUT and USETO precedes an OUTPUT (i.e., 
USETI is illegal for a non-privileged program unless a LOOKUP has been done, and USETO is illegal 
for a non-privileged program unless an ENTER has been done). However, there are special cases when 
updating a file (both a LOOKUP and an ENTER have been done) when USETI may be followed by an 
OUTPUT and USETO may be followed by an INPUT. The action performed on a USETI or USETO de- 
pends on the value of N. 

When N is a block number less than or equal to the current size of the file in blocks (i.e., N is a block 
that has been previously written), USETI or USETO points to block N in order to read or write that 
block on the next INPUT or OUTPUT . 



The number of extended RIBs allowed on the system can be changed with MONGEN and can be ob- 
tained from a GETTAB table (.GTLVD, item 23). Extended RIBs depend on FTMRIB which is normally 
off in the DECsystem-1040. 
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When N is a block number greater than the current size of the file in blocks, USETI followed by an 
INPUT receives the end-of-file return (e.g., if the file is 5 blocks long, USETI with n=7 receives 
the end of file return). On a USETO followed by an OUTPUT, the monitor allocates the intervening 
blocks, writes zeroes in the first new block up to block N-1, and then writes block N. For example, 
if the file is 2 blocks long, USETO with n=4 writes zeroes in block 3 and the data on the OUTPUT in 
block 4. If the number of blocks requested cause the disk to be filled or the user's quota. to be exceeded, 
as many blocks as allowed will be allocated and the lO.BKT bit will be set in the status word. In 
addition, in update mode, USETI followed by an OUTPUT appends the data to the end of the file 
(i.e., makes the file larger). USETO followed by an INPUT allocates and zeroes the first new block 
up to block N-1 and then receives the end-of-file return. 

When N=0 on reading, writing, and updating, USETI and INPUT read the prime RIEJ, and USETO and 
OUTPUT receive the lO.BKT error. In addition, in update mode, USETO and INPUT read the prime 
RIB, and USETI and OUTPUT receive the lO.BKT error. 

When N=-2 to -lOg, a USETI and INPUT read the indicated extended RIB (-2 is the 2nd RIB,..., 
-lOg is the 8th RIB). USETO followed by an OUTPUT attempts to allocate a large number of blocks 
(since N is interpreted as an unsigned integer) and therefore is not recommended because the user's 
disk quota will probably be exceeded. 

When N=-l, USETO and OUTPUT rewrite the last block in which I/O was performed. USETI and IN- 
PUT receive the end of file return. In addition, in update mode, USETI followed by OUTPUT appends 
the data to the end of the file, and USETO and INPUT read the last block in which I/O was performed. 

The user can append data to the last block of an append-only file by specifying a USETO followed by 
an OUTPUT to the last block. The monitor then reads the block (of N words) into a monitor buffer, 
copies words N+1 through 200 from the user's buffer into the monitor buffer, and rewrites the block. 
The current length of the block can be obtained from the LOOKUP/ENTER block. It is not necessary 
to read the last block of the file before appending to it because the data already existing in the block 
is not changed. 

When appending data to the last block of a file, the lO.BKT bit is set and no output is done if 

1) Any block before the last block is written. 

2) The last block already contains 200 words. 

3) Fewer blocks are written than the current size of the block. 

If the last block is written with a buffer-mode OUTPUT, the size of the last block becomes 200 words, 
and therefore, cannot be appended to. 

Append-only files can be read only if FTAIR is on. Note that BASIC stores data at the beginning 
of files that it must read and therefore, to run BASIC, FTAIR must be turned on. 



This feature depends on FTAPLB, which is normally off in the DECsystem-1040. Therefore a new 
block must be written in order to append to a file, 
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If no previous LOOKUP or ENTER has been done, these UUOs are considered to be super-USETI and 
super-USETO which are available only to privileged programs. If the program is non -privileged, 
super-USETI and super-USETO cause the lO.BKT bit to be set in the status word. These privileged 
UUOs are documented in UUOPRV.RNO in the DECsystem~10 Software Notebooks. 

6.2.9.3 SEEK UUO^ - This UUO, when used in coni'unction with USETI and USETO, allows user pro- 
grams control over the time at which positioning operations occur. Following a regular USETI or 
USETO, positioning is to the cylinder containing the requested relative block within a file. Following 
a super-USETI or super-USETO, positioning is to the cylinder containing the specified disk block. 



The call is; 



SEEK AC, ; or CALLI D, 56 

return 



D specifies a software channel number. The SEEK UUOs are honored by the monitor only if the unit 
for which they are issued is idle. If the unit is in any other state, the SEEK UUO is a no-operation. 

SEEK UUOs issued for public file structures are treated in the same way as private file structures. 
This allows users to debug programs using a public disk pack and later run the same programs using a 
private disk pack. 

The following is proper UUO sequence for issuing a SEEK. 
For output 

a. USETO to select a block (relative or actual) 

b. SEEK to request positioning 

c. computations 

d. OUTPUT to request actual output 

For input 

a. USETI to select a block (relative or actual) 

b. SEEK to request positioning 

c. computations 

d. INPUT to request actual input. 

6.2.9.4 RESET UUO - This UUO causes files that are in the process of being written, but have not 
been CLOSEd or RELEASed, to be deleted; the space is reclaimed. If a previous version of the file 
with the same name and extension existed, it remains unchanged on the disk (and in the UFD). If the 
programmer wishes to retain the newly created file and to delete the older version, he must CLOSE or 
RELEASe the file before doing a RESET UUO. 



Hhis UUO depends on FTDSEK which is normally off in the DECsystem-1040. 
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6.2.9.5 DEVSTS UUO - After each interrupt, FILSER stores the results of a CONI In the DEVSTS 
word of the device data block. The DEVSTS UUO is used to return the contents of the DEVSTS word 
to the user (refer to Paragraph 4. 10. 1). 

I 6.2.9.6 CHKACC UUO - This UUO allows programs to check the user's access to a particular file. 
The call is: 

MOVE AC, CEXP LOC] 

CHKACC AC, ;or CALLI AC, 100 

error return 

normal return 

The LH of LOC contains the code for the type of access to be checked and the RH of LOC contains a 
9-bit protection field. If the access code contained in the LH of LOC is greater or equal to 7, then 
the RH of LOC is interpreted as UFD privilege bits. LOC+1 contains the project -programmer number 
of the directory, and LOC+2 contains the proiect-programmer number of the user. 

The type of access to be checked is represented by one of the following codes: 





1 


.ACCPR 
.ACREN 


Change protection. 
Rename. 


2 


.ACWRI 


Write. 


3 

4. 
5 


.ACUPD 
.ACAPP 
.ACRED 


Update. 
Append. 
Read. 


6 


.ACEXO 


Execute only. 


7 


.ACCRE 


Create in UFD. 


10 


.ACSRC 


Read directory as a file. 



The error return is given if the UUO is not implemented. On a normal return, AC contains if access 
is allowed or -1 if access if not allowed. 

6.2.9.7 STRUUO AC, or CALLI AC, 50 - This UUO manipulates file structures and is intended pri- 
marily for monitor support programs. 

The call is: 

MOVE AC, CXWD N, LOC] 

STRUUO AC, ;or CALLI AC, 50 

error return ;AC contains an error code 

normal return ;AC contains status information 

N is the number of words in the argument list starting at location LOC. For the functions with a fixed 
length argument list, N may be 0. 

The first word of the argument list specifies the function to be performed. Function (.FSSRC) is the 
only unprivileged function; the remaining functions are available only to jobs logged-in under [1,2] 



This UUO depends on FT5UUO which is normally off in the DECsystem-1040. 
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or to programs running with the JACCT bit set. Refer to the Specifications section of the DECsystem- 
10 Software Notebooks for a complete description of the privileged functions and their appropriate 
error codes. 

The present functions are as follows: 



Function 



Name 
FSSRC 



FSDSL 



Define a new search list for this I'ob. This is the only 
unprivileged function. 

Define a new search list for any job or for the system. 
Privileged function. 

Define a new file structure. Privileged function. 

Redefine an existing file structure. Privileged function. 

Prevent any further new INITs, ENTERs, or LOOKUPs. 

Privileged function. 

Remove file structure from system. Privileged function. 

Test and set UFD interlock. Privileged function. 

Clear UFD interlock. Privileged function. 

Simulate disk hardware errors. Privileged function. 

6.2.9.7.1 Function .FSSRC - This function allows a new file structure search list to be specified 
for the I'ob issuing the UUO. The call is: 



2 


.FSDEF 


3 


.FSRDF 


4 


.FSLOK 


5 


.FSREM 


6 


.FSULK 


7 


.FSUCL 


10 


.FSETS 





MOVE AC, CXWD N, LOCI 




STRUUOAC, 




error return 




normal return 


LOC: 





LOC+1 


first file structure name 


LOC+2 





LOC+3 


status bits 


LOC+4 


second file structure name 


LOC+5 





LOC+6 


status bits 



;. FSSRC 



The argument list consists of word triplets, which specify the new search list order to replace the cur- 
rent search list. The current search list may be determined with the JOBSTR UUO. The first word 
contains a left-justified file structure name in SIXBIT. The second word is not used at present. The 
third word contains the following status bits: 

Bit = 1 if software write-protection is requested for this file structure. 

Bit 1 = 1 if files are not to be created on this file structure unless the specific 
file structure is specified in an ASSIGN command or in an INIT or 
OPEN UUO. 

The user may use the MOUNT command to add a new file structure name to his search list. The 
MOUNT program 
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a. Requests the file structure to be mounted (if it is not already mounted). 

b. Creates a UFD for the user if he has a logged-in quota in file SYS: QUOTA. SYS 
on that file structure. 

A user cannot create files on a file structure unless he or the proi'ect-programmer number specified has 
a UFD on that file structure. However, by using the .FSSRC function, the user may add a file structure 
name to his search list if the file structure is mounted and either the user has a UFD for that file struc- 
ture or he does not want to write on that file structure. If the user attempts to delete a file structure 
name from his search list by the .FSSRC function, the monitor moves the file structure name from the 
active search list to the passive search list. The DISMOUNT command must be used to remove the file 
structure from the active or passive search list. The DISMOUNT command causes the mount count to 
be decremented, signifying that the user is finished with the file structure, and checks that the user 
has not exceeded his logged-out quota on the file structure. 

Table 6-7 
.FSSRC Error Codes 



Symbol 


Code 


Explanation 


FSILF% 

FSSNF% 

FSSSA% 

FSTME% 

FSRSL% 



1 
2 
4 
17 


Illegal function code. 

One or more file structures not found. 

One or more file structures single access only. 

Too many entries in search list. 

File structure is repeated in a search list definition. 



6.2.9.8 JOBSTR AC, or CALLI AC, 47 - This UUO returns the next file structure name in the job's 
search list along with other information about the file structure. Programs like DIRECT use this UUO to 
list a user's directory correctly and specify in which file structures the files occur, as well as the order 
in which they are scanned. 
The call is: 



MOVE AC, [XWD N,LOC] 
JOBSTR AC, 
error retufn 
normal return 



;or CALLI AC, 47 



LOC is the address of the N-word argument block . When the UUO is called, the first word should be 
one of rtie following: 

a. -1 to return the first file sfructure name in the search list. 

b. a file structure name to return the next file structure following tfie specified name. 

c . to return the file structure name immediately following the FENCE. Refer to 
Paragraph 6.2.7. 



In the DECsystem-1040, FTSTR is normally off so that there is only one file structure on the system. 
However, this UUO is Implemented and returns the file structure name or -1 . 
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On return, the first word contains: 

a. the first file structure name in the search list if -1 was specified. 

b. the next file structure name appearing after the specified name or after the FENCE 
(if was specified). 

c . if the item after the specified name is the FENCE. 

d. -1 if there are no more file structure names in the search list, or the search list is 
empty . 

The second word contains (reserved for a future argument), and the third word contains status bits. 
Current status bits are: 

Bit = 1 if software write protection is in effect for this job . 

Bit 1=1 if files are not to be created on this file structure, when a 
multiple file structure name is specified in dn INIT or OPEN 
UUO. Files can be created if a specific file structure or 
physical unit is specified. 

The following is an example of reading a job's search list. 

SETOM LOC . ;place -1 in LOC to get 1st 

;name in search list. 

LOOf>:MOVEI AC, LOC ;set up AC . 

JOBSTRAC, ;dotheUUO. 

JRST ERROR ;error return . 

MOVE AC, LOC ;get file structure name returned. 

JUMPE AC, FENCE ;jump if it is the FENCE. 

AOJE AC, END ;jump if end of search list (-1). 

;LOC has next file structure name. 

JRST LOOP ;repeat with next file structure name. 

LOC: -1 ;file structure name. 

/reserved for future use . 

;statusbits. 

6.2.9.9 GOBSTR AC, or CALLI AC, 66 - This UUO returns successive file structure names in the 

search list of either an arbitrary job or the system. TTie GOBSTR UUO is a generalization of the 

JOBSTR UUO (see Paragraph 6.2.9.8). It is a privileged UUO unless information being requested is 

either about the system search list or the jobs logged-in under the same project-programmer number as 

the calling job's number. For example, the KJOB program needs information about the search lists 

of jobs logged in under the same project-programmer number as the job logging out. The privilege bits 

required are either JP.SPA (bit 16) or JP.SPM (bit 17) of the fjrivilege word (.GTPRV). 

The call is: 

MOVE AC, CXWD N,lOC] 

GOBSTR AC, ;or CALLI AC, 66 

error return ;AC contains an error code 

normal return 
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When the UUO is called, AC specifies the length (N) and address (LOG) of an argument list. N may 
be 0, 3, 4, or 5 where N = has the same effect as N = 3. Only the arguments included by N(LOC, 
LOC+1 ,. . .,LOC+N-l) are used or returned. The argument list is as follows: 

LOG: job number ;iob whose search 

;list is desired. 
XWDpro|,prog ;pro|ect-programmer 

;number of above job . 
SIXBIT/file structure name/ ;or -1 or 0. 
;currently unused. 

Status ;status bits are the same 

;as in JOBSTRUUO. 

If the job number = -1 , the number of the job issuing the UUO is used. If the job number = 0, the 
given project-programmer number is ignored and the system search list is used. When the given 
project-programmer number is -1, the project-programmer number of the job issuing the UUO is used. 

On an error return, AG contains one of the following error codes: 

Gode Meaning 

3 If LOG+2 is not 0, -1, or a file structure name in jobs 



searc 



h list. 



6 If job number (LOG) and project-programmer 

number (LOG +1) do not correspond. 

TO If job issuing the UUO is not privileged. 

12 If the length specified for the argument list is not 

valid. 

6.2.9.10 SYSSTR AG, or GALLI AG, 46 - This UUO provides a simple mechanism to obtain all the 

file structure names in ibe system. The proper technique to access all files in all UFDs is to access the 

MFD on each file structure separately. Monitor support programs use this UUO to access all the files 

in the system. 

The call is: 



MOVEI AG, or the last value returned by previous SYSSTR 
SYSSTR AG, ;or GALLI AG, 46 

error return 
normal return 

An error return is given if either 

a . The UUO is not implemented 

b. The argument is not a file structure name 

On a norma! return, the next public or private file structure name in the system is returned in AG. A 
return of in AG on a normal return means that the list of file structure names has been exhausted. If 
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is specified as an argument-, fhe first file structure name is returned in AC. The argument cannot be 
a physical disk unit name or a logical name. 

6.2.9.11 SYSPHY AC, or CALLI AC, 51^ -This UUO returns all physical disk units in the system. 
The SYSPHY UUO is similar to the SYSSTR UUO (see Paragraph 6.2.9.10). 

The call is: 

MOVEI AC, or the last unit name returned by previous SYSPHY 
SYSPHY AC, ; or CALLI AC, 51 

error return ;hot implemented or not a physical disk 

normal return ;unit name 



On the first call AC should be to request the return of the first physical unit name. On subsequent 
calls, AC should contain the previously returned unit name. 

An error return is given if AC does not contain a physical disk unit name as zero. On a normal return, 
the next physical unit name in the system is returned in AC. A return of in AC indicates that the 
list of physical units has been exhausted. 

6.2.9. 12 DEVPPN AC, or CALLI AC, 55^ - This UUO allows a user program to obtain the project- 
programmer number associated with a disk device. The device argument given can be a logical device 
name, d physical device name, or one of the special devices called ersatz devices, (Refer to DEC- 
system-10 Operating System Commands for the list of system devices.) 

When the UUO is called, AC must contain either the device name as a left-justified SIXBIT quantity, 
or the channel number of the device as a right -justified quantity. 



The call is: 



MOVE AC, [SIXBIT /DEV/I ;or MOVEI AC, channel number 

DEVPPN AC, ;or CALLI AC, 55 

error return 
normal return 



The error return is taken if: 



This UUO depends on FT5UUO which is normally off In the DECsystem-1040. 
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a. The UUO is not implemeiU'ecl; therefore, the contents of AC remain the same on 
return. In this case, detain the appropriate project -programmer number as follows: 

1 . For the user's area, use the GETPPN UUO (refer to Paragraph 3.6.2.3). 

2. For the special ersatz devices, use the default project-programmer numbers 
appearing in the following list. 

Device Project-programmer Number 

ALL: User's project-programmer number 

BAS: [5,1] 

COB: [5,2] 

DSK: User's project-programmer number 

HLP: [2,5] 

LIB: Set by each user 

MXI: [5,3] 

NEW: [1,5] 

OLD: [1,3] 

SYS: [1,4] 

b . The device does not exist or the channel is not INITed; therefore, zero is 
returned in AC. 

c. The device is not a disk; the user's project-fwogrammer number is returned in AC. 

If a legal device is specified, the normal return is given and the project-programmer nurrter associated 
with the device is returned in AC. However, if the user has device NEW: enabled in his search list 
and device SYS: is given as the argument to the DEVPPN UUO, the project-programmer number 
returned is [1,5] . 
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The ibilowing is an example for reading a UFD if either device SYS or the user's area is specified. 



MOVEI A, 16 

GETTAB A, 

MOVE A,tl,,l3 

MOVEM A,MFDPPN 



MOVE 


A,OEVNAM 


MOVEH 


A,MODE+l 


DEVPPN 


A, 


JRST 


GETPPX 



;GET HFO PROJECT-PROGRAMMER NUMBER 
;N0 CHANGE IF NO GETTAB 
; IN CASE OF UEVEL C 
;STORE MFD DIRECTORY NUMBER 

;GET DEVICE NAME TYPED BY USER 

;STORE FOR OPEN 

rGET PROJECT PROGRAMMER NUMBER 

; NOT IMPLEMENTED OR NO SUCH DEVICE 



;BACK here WITH IMPLIED PPN IN A 
GOTPPNI MOVEh A, PPN 



OPEN 


I, MODE 


JRST 


ERROR 


LOOKUP 


I, PPN 


JRST 


ERROR 


IN 


I, 


JRST 


USEIT 


JRST 


ERROR 


;HERE if DEVPPN 


FAILS 


GETPPX J CAMN 


A, (SIX 


JRST 


GETPPS 


GETPPN 


A, 


JFCL 




JRST 


GOTPPN 



fSTORE PPN IMPLIED BY DEVICE NAME 

?TRY TO OPEN DEVICE 
;NQT AVAILABLE 
;TRY TO LOOKUP UFD 

;not there 

;REAU first BLOCK 
fGO 00 USEFUL WORK 
;ERR0R or END OF FILE 



A, ISIXBIT /5YS/1 ISEE IF DEVICE NAME SYS: 
;YES— GO HANDLE SYS! 
;N0— GET OWN PPN 
HIN CASE OF JACCT) 
;0K — PROCEED ABOVE 



GETPPSI MOVE A, tl,,l63 

GETTAB A, 

HOVE A,U»,IJ 

JRST GOTPPN 



;FIND SYSJ PPN 

;from monitor tables 
?cin case of lev. c) 

yOK— PROCEED ABOVE 



MODE: U 

0,ilNBUFH 

PPN; 

SIXBIT VUFD/ 


MFOPPNJ I,, I 



;BINARY READ 
/DEVICE NAME 
/BUFFER HEADER 

/DIRECTORY NAME 
/EXTENSION 

/LOOKUP UFO IN MFD 
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6.2.9. 13 DSKCHR AC, or CALLI AC, 45 - The disk characteristics UUO provides necessary infor- 
mation for allocating storage efficiently on different types of disks. Most programs are able to use the 
generic device name DSK rather than special disk names; however, this UUO is needed by special 
monitor support programs. - ■ 

This UUO accepts, as arguments, names of file structures (e.g., DSKA), types of controllers (e.g., 
DP), controllers (e.g., DPA), logical units (e.g., DSKA3), physical disk units (e.g., DPA3), or 
logical device names (e.g., ALPHA). If the argument in LOC specifies more than one unit, the values 
returned in AC are for the first unit of the specified set. If the argument specifies more than one file 
structure (i.e., DSK or logical device name for disk), the first unit of the first file structure is returned. 



The call is: 



MOVE AC, [XWD+N,LOC] 



DSKCHR AC, 
error return 
normal return 



;N is the number of locations 
;of arguments and values starting 
;at location LOC 

;or CALLI AC, 45 
;not a disk 



On a normal return, AC contains status information in the left half and configuration information in 
the right half. The left half bits have been chosen so that the normal state is 0. 



Name 


Bit 


Explanation 


DC.RHB 


Bit = 1 


The monitor must reread the home block before the next 
operation to ensure that the pack ID is correct. The 
monitor sets this bit when a disk pack goes off-line. 


DC.OFL 


Bit 1 = 1 


The unit is off-line. 


DC.HWP 


Bit2 = 1 


The unit is hardware write -protected. 


DC.SWP 


Bit 3 = 1 


The unit belongs to a file structure that is write- 
protected by software for this job. 


DC.SAF 


Bit 4 = 1 


The unit belongs to a single-access file structure. 


DC.ZMT 


Bit 5 = 1 


The unit belongs to a file structure with a mount count 
that has gone to zero (i.e., no one is using the file 
siructure). Available in 5.02 monitors and later. 




Bit6 = l 


Reserved for the future. 


DC.STS 
. DCSTD 
.DCSTN 

.DCSTP 


Bits 7 and 8 
= 11 
= 10 
= 01 
= 00 


Unit status 
The unit is down. 
No pack is mounted. 
Reserved for the future. 
A pack is mounted . 


DC. MSB 


Bit 9 = 1 


The unit has more than one SAT block. 


DC.NNA 


Bit 10 = 1 


The unit belongs to a file structure for which the 
operator has requested no new INITs, LOOKUPs, or 
enters; set by privileged STRUUO function. 


DC. AWL 


Bit 11 =1 


Hie file structure is write-locked for all jobs. 




Bits 12 - 14 


Reserved fcM- future expansion . 
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Name 


Bit 


Explanation 


DC.TYP 


Bits 15 - 17 


The code identifies which type of argument was passed 
to the monitor in location LOC . 


DC.DCN 


Bits 18-20 


Data channel number that software believes hardware 
is connected to; first data channel is 0. 


DC.CNT 
.DCCFH 
.DCCDP 


Bits 21 -26 
= 1 
= 2 


Controller type: 

FH (Burroughs disk, Bryant drum) controller RC 10 
DP (Memorex disk packs) controller RPIO 


DC. CNN 


Bits 27 - 29 


Controller number; first controller of each type starts at 
0(e.g., DPA=0, DPB = 1) 


DC.UNT 


Bits 30 - 32 


Unit type; a controller-dependent field used to distin- 
guish various options of a unit on its controller. 

If bits 21 - 26 and bits 30-32 then type is 

1 RDIO Burroughs disk (.DCUIFD) 

1 1 RMIOB Bryant drum (.DCUFM) 

2 1 RP02 disk pack (.DCUb2) 
2 2 RP03 disk pack (.DCUD3) 


DC.UNN 


Bits 33 - 35 


Physical unit number within controller; first unit is 



The user program supplies in location LOC a left-justified, SIXBIT disk name which may be one of the 
following: 



.DCTDS 





generic disk name 


. DCTAB 


1 


subset of file structures because of file structure abbreviation 


.DCTFS 


2 


file structure name 


.DCTUF 


3 


unit within a file structure 


.DCTCN 


4 


controller type 


. DCTCC 


5 


controller 


.DCTPU 


6 


physical disk unit name 



or a logical name for one of the above assigned by the ASSIGN or MOUNT monitor command. 
On a normal return, the monitor returns values in the following locations: 



LOC+1 (.DCUFT) 



LOC+2(.DCFCT) 

LOC+3(.DCUNT) 
LOC+4(.DCSNM) 
LOC+5(.DCUCH) 



The number of blocks left of the logged-in job quota before the UFD 
of the I'ob is exhausted on the unit specified in LOC. If negative, 
the UFD is overdrawn. If the negative number is 400000 000000, 
the UFD has not been accessed since LOGIN; therefore, the monitor 
does not know the quota. 

The number of blocks on a first-come first-served basis left for ail 
users in the file structure. 

The number of blocks left for all users on the specified unit. 

The file structure name to which this unit belongs. 

Characteristic sizes 

a. Bits 0-8 are the number of blocks/cluster (DC.UCC) 

b. Bits 9-17 are the number of blocks/track (DC.UCT) 

c. Bits 18-35 are the number of blocks/cylinder (DC.UCY) 
(see Appendix F). 
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LOC+6(.DCUSZ) 
LOC+7(.DCSIvfT) 

LOC+10(.DCWPS) 
LOC+n (.DCSPU) 
LOC+12(.DCK4S) 
LOG+13(.DCSAJ) 



LOC+14(.DCULN) 
LOC+15(.DCUPN) 
LOC+16(.DCUID) 
LOC+17(.DCUFS) 



The number of 128-worcl blocks on f he specified unit. 

The mount count for the file structure. The mount count is the number 
of jobs that have done a MOUNT command for this file structure with- 
out executing a DISMOUNT command; it is a use count. 

The number of words containing data bits per SAT block on this unit. 

Number of SAT blocks per unit. 

Number of K allocated for swapping. 

Zero if none or more than one job has this file structure mounted. 
XWD -1, ,n if only lob n has file structure mounted but it is not single 
access. XWD 0, ,n if I'ob has file structure mounted and it is single 
access. 

The unit's logical name (e.g., DSKBO). 

The unit's physical name (e.g., DRAG). 

The unit's ID (e.g., 2RP003). 

The first logical block used for swapping on this unit. 



6.2.9.14 DISK. AC, or CALL! AC, 121 - The DISK. UUO is a general-purpose call designed for 
setting and examining parameters of the disk and file systems. Its present function allows the user to 
assign a priority for disk operations (data transfers and head positionings) either for a user I/O channel 
or for his job (all I/O channels). Therefore, when a disk operation is initiated, the request with the 
highest priority is selected. If there is more than one request with the same priority, the one most 
satisfying disk optimization is chosen (refer to Chapter 7). 

The range of permissible disk priorities is -3 to +3 with being the normal timesharing priority. Thus, 
a I'ob can request a lower than normal priority (e.g., when the job is a background I'ob). The maximum 
priority (greater than 0) that the user is allowed to assign is set by bits 1 and 2 (J P. PRI) of the privilege 
word .GTPRV. 



The call is: 



MOVE AC, [XWD function, ADR] 
DISK. AC, 
error return 
normal return 



The present function is 
Function 




Name 
.DUPRI 



;orCALLI AC, 121 



Description 

Set the disk priority 



ADR contains, in the right half, the desired priority (-3 to +3) and in the left half, one of the 
following; 

LH (ADR) = n Sets the priority for channel n (n is from to 17). 

LH (ADR) = -1 Sets the priority for all channels OPENed by the job. 

LH (ADR) = -2 Sets the priority for the entire fob. 
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When a priority is set for a channel, it overrides any priority set for the \ob and remains in effect 
until the channel is RELEASed. When set for the job, the priority remains in effect until RESET 
by another DISK. UUO or the SET DSKPRI command (refer to DECsystem-IO Operating System 
Commands) . 

6.2.9.15 Simultaneous Supersede and Update - Files that may be simultaneously superseded or up- 
dated by several different users should be treated with care. The problem arises when one user has a 
copy of information to be superseded by another user. For example, file F contains a count of the 
number of occurrences of a certain event. The count is 10 at a given time. When two users observe 
separate instances of the event, each tries to increment the count. 



Supersede - Incorrectly 

Job 1 
LOOKUP A, F 

READ COUNT (=10) 
ADD 1 (=1 1) 

ENTER B, F 
WRITE OUT (=11) 
CLOSE B, 



Job 2 

LOOKUP C, F 
READ COUNT (=10) 
ADD 1 (=11) 



ENTER D, F 

ENTER D, F 
WRITE OUT (=11) 
CLOSE D, 



(Fail) 
(Succeed) 



In this example, job 2 ignored job I's increment. 



Supersede - Correctly 

Job 1 



ENTER B, F 
LOOKUP A, F 

INPUT A, (=10) 
ADDl (=11) 
OUTPUT B, (=11) 
CLOSE B, 



Job 2 



ENTER D, F 



ENTER D, F 
LOOKUP C, F 
INPUT C, (=11) 
ADDl (=12) 
OUTPUT D, (=12) 
CLOSE D, 



(Fall) 



(Succeed) 



In this example, both jobs performed the ENTER FIRST; therefore, incorrect copies were not made and 
the increment of each job was recorded properly. 
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The similar problem with a update can be avoided by never using the information returned by the 
LOOKUP: 

Job 2 



Job 1 

LOOKUP A, F 
INPUT A, 

ENTER A, F 

OUTPUT 

CLOSE 



LOOKUP B, F 
INPUT B, 

ENTER B, F 
Here any information 
from the LOOKUP and 
INPUT must be discarded. 



(Fail) 



6.2.10 File Status (refer to Appendix D) 
The file status of the disk is shown below. 

18 21 24 27 30 33 35 



SET BY USER 



18 



SET BY MONITOR 



Bit 18- lO. IMP 



Bit 19-IO.DER 
Bit 20 -lO. DTE 

Bit 21 -lO.BKT 



a. INPUT UUO attempted on a read-protected file 

b . INPUT UUO when no LOOKUP was done (or 
super-USETl/USETO previously attempted by 
nonprivileged user) 

c .. OUTPUT UUO when no ENTER was done (or 
super-USETl/USETO previously attempted by 
nonprivileged user) 

d. Software-detected checksum error 

e. Software-detected redundancy error in SAT block or 
RIB, or 

f . Buffered mode I/O attempted after super-USETl/ 
USE TO . 

g. OUTPUT UUO attempted on a write-locked unit. 

Search error, power supply failure 

Disk or data channel parity error. 
Checksum failure on INPUT. 

a . Quota is exhausted (past overdrawn) 

b. File structure is exhausted 

c. RIB is full 

d. Super-USETl/USETO block is too large for the file 
structure 



(continued on next page) 



6-55 



March 1973 



MONITOR CALLS 



-502- 



Bit 21 -lO.BKT 
(cont) 



e. More than 777777 blocks were read with one super- 
USETI/USETO 

f . Block number specified is too low for writing in a 
file that has an append protection code (4). The 
block number must be greater than the current 
highest block number of the file. Not set on a 
USETI or USETO. 

g. A super-USETI or USETO was issued by a non -privileged 
program. 



Bit 22 -lO.EOF 



Bit 23 -lO. ACT 



EOF encountered on INPUT. No special character appears in 
the buffer . 

Device is active 

18 21 24 27 30 33 35 



UNUSED 



18 21 24 27 29 30 33 35 



SET BY USER 



Bit 29 - lO.WHD Write disk pack headers 

6.2.11 Disk Packs 

A disk pack system combines disk and the DECtape features. Some packs (similar to individual DEC- 
tapes) are designed to be private, assignable, and removable. The other packs make up part or all of 
the public disk storage area where system programs and user files are stored. These disk packs belong 
to file structures in the storage pool and cannot be assigned to any single user. The system library and 
shared on-line storage is maintained and swapping storage is assigned within the public disk pack area. 

The only distinction between public and private packs is that private packs are intended to be removed 
from the system during regular operation. Public packs usually stay on-line all the time. However, 
the file structure format for public and private disk packs is identical . 

User programs can exercise much greater control over private packs. For example, a program may 
attempt to position the arms of disk packs in anticipation of future I/O (refer to Paragraph 6.2.9.3). 
Tills capability is useful to a program that is aware of the contents of a disk and is able to use this 
information to optimize positioning. The program may also specify the position of files on the disk by 
using the allocate arguments of the extended LOOKUP, ENTER, and RENAME UUOs. 

Private packs may be accessed by inore than one job (multi -access) or restricted to only one job (single 
access) . To access a private file structure, the user must type the MOUNT monitor command. If the 
private file structure is already mounted, on-line, and multi-access, the user receives an immediate 
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response and may starf using the private pack. When ihe user is finished using the private file struc- 
ture, he should type the DISMOUNT monitor command. If no other job is using the file structure, a 
message is typed to the operator informing him that the drives belonging to the file structure are free. 

6.2 .] 1 .1 Removable File Structures - AH file structures arf designed as if they could be removed 
from the system; therefore, disk packs are handled the same as other types of disks. 

6.2.11 .2 Identification - Disk packs have identifying information written on the home block, a 
block on every unit identifying the file structure to which the unit belongs and its position within the 
file structure. Part of this information is the pack ID, a one- to six-character SIXBIT name uniquely 
identifying the disk pack . The MOUNT and OMOUNT programs check that the operator has mounted 
the proper packs by comparing the pack ID in the home block with the information stored in the system 
administration file STRLST.SYS. 

6.2 .11 .3 IBM Disk Pack Compatibility - The data format of IBM disk packs has variable-length 
sectors and no sector headers. DEC format has fixed-length sectors (128 words) and specially written 
sector headers. Latency optimization is employed to improve system throughput (refer to Paragraph 
7.3) . dec's signrficantly simpler hardware controller is used without reducing user capabilities. 

To transfer data from a IBM pack system to a DEC pack system, a simple program in a higher-level 
language should be written for both machines. The program then reads the IBM disk pack on the IBM 
computer and writes the files onto magnetic tape. The magnetic tape is then transferred to a DEC 
computer and read by another program, which writes the files onto the DEC RPOl or RP02 packs. 

6.3 SPOOLING OF UNIT RECORD I/O ON DISK 

Devices capable of spooling (card reader, line printer, card punch, paper-tape punch, and plotter) 
have an associated bit in the job's .GTSPL word. If this bit is on when the device is ASSIGNed or 
INITed, the device is said to be in spool mode. While in this mode, all I/O for this device is inter- 
cepted and written onto the disk rather than onto the device. System spooling programs later do the 
actual I/O transfer to the device. 

Spooling allows more efficient use of the device because users cannot tie it up indefinitely. In 
addition, since the spooling devices are generally slow and the jobs that are to be spooled are usually 
large, the jobs do not spend unnecessary time in core. 
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6.3.1 Input Spooling 

If a LOOKUP is given after the INIT of the card reader, it is ignored and an automatic LOOKUP is 
done, using the filename given in the last SET CDR command and the filename extension of .CDR. 
After every automatic LOOKUP, the name in the input-name counter .GTSPL is incremented by 1 so 
that the next automatic LOOKUP will use the correct filename. 

6.3.2 Output Spooling 

If an ENTER is done, the filename specified is stored in the RIB in location .RBSPL so that the output 
spooler can label the output. Therefore, programs should specify a filename if possible. 

If an ENTER is not done, an automatic ENTER is given, using a filename in the general form 
xxxyyy.zzz 

where xxx is a three-character name manufactured by the monitor to make the 

9-character name unique. 

yyy is (1) an appropriate station number Snn if a generic device name is 
INITed or (2) a unit number if a specific unit is INITed. 

zzz is the generic name of the device-type (LPT, CDP, PTP, or PLT]i. 

Output spooling should not concern the user because all requests are queued when the user logs off th© 
system. TTie files are moved to the output queues before the logged-out quota is computed. 
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CHAPTER 7 

MONITOR ALGORITHMS 



7.1 JOB SCHEDULING 

The number of jobs that may be run simultaneously must be specified in creating the DECsystem-10 
/Monitor. Up to 127 jobs may be specified. Each user accessing the system is assigned a job number. 

In a multiprogramming system all jobs reside in core, and the scheduler decides what jobs should run. 
In a swapping system, jobs exist on an external storage device (usually disk or drum) as well as in 
core. The scheduler decides not only what job is to run but also when a job is to be swapped out onto 
the disk (drum) or brought back into core. 

In a swapping system, jobs are retained in queues of varying priorities that reflect the status of the 
jobs at any given moment. Each job number possible in the system resides in only one queue at any 
time. A job may be in one of the following queues: 

a. Run queues - for runnable jobs waiting to execute. (There are three run queues of 
different levels of priorities.) 

b. I/O wait queue - for jobs waiting while doing l/O . 

c. I/O wait satisfied queue - for jobs waiting to run after finishing I/O. 

d. Sharable device wait queue - for, jobs waiting to use sharable devices. 

e. TTY wait queue - for jobs waiting for input or output on the user's console. 

f . TTY wait satisfied queue - for jobs that completed a TTY operation and are await- 
ing action. 

g. Stop queue - for processes that have been completed or aborted by an error and 
are awaiting a new command for further action. 

h. Null queue - for all job numbers that are inactive (unassigned) . 

Each queue is addressed through a table. The position of a queue address in a table represents the 
priority of the queue with respect to the other queues. Within certain queues, the position of a job 
determines its priority with respect to the other jobs in the same queue. For example, if a job is first in 
the queue for a sharable device, it has the highest priority for the device when it becomes available. 
However, if a job is in an I/O wait queue, it remains in the queue until the I/O is completed. 
Therefore, in an I/O wait queue, the job's position has no significance. The status of a job changes 
each time it is placed into a different queue. 
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Each job, when it is assigned to run, is given a quantum time. When the quantum time expires, the 
job ceases to run and moves to a lower priority run queue. The activities of the job currently running 
may cause it to move out of the run queue and enter one of the wait queues. For example: when a 
currently running job begins input from a DECtape, it is placed in the I/O wait queue, and the input 
is begun. A second job is set to run while the input of the first job proceeds. If the second job then 
decides to access a DECtape for an I/O operation, it is stopped because the DECtape control is busy, 
and it is put in the queue for jobs waiting to access the DECtape control . A third job is set to run. 
The input operation of the first job finishes, making the DECtape control available fro the second job. 
The I/O operation of the second job is initiated, and the job rs transferred from the device wait queue 
to the I/O wait queue. The first job is transferred from the I/O wait queue to the highest priority run 
queue. This permits the first \ch to preempt the running of the third job. When the quantum time of 
the first job becomes zero, it is moved into the second run queue, and the third job runs again until 
the second job completes its I/O operations. 

Data transfers also use the scheduler to permit the user to overlap computation with data transmission. 
In unbuffered modes, the user supplies an address of a command list containing pointers to relative 
locations in the user area to and From which data is to be transferred. When the transfer is initiated, 
the job is scheduled into an I/O wait queue where it remains until the device signals the scheduler 
that the entire transfer has been completed. 

In buffered modes, each buffer contains a use bit to prevent the user and the device from using the 
same buffer at the same time (refer to Paragraph 4.3). If the user overtakes the device and requires 
the buffer currently being used by the device as his next buffer, the user's job is scheduled into an 
I/O wait queue. When the device finishes using the buffer, the device calls the scheduler to reacti- 
vate the job. If the device overtakes the user, the device is stopped at the end of the buffer and is 
restarted when the user finishes with the buffer. 

Scheduling occurs at each clock tick (l/60th or l/50th of a second) or may be forced at monitor level 
between clock ticks if the current job becomes blocked (unrunnable). The asynchronous swapping al- 
gorithm is also called at each clock tick and has the task of bringing a job from disk into core. This 
function depends on 

a. The core shuffling routine, which consolidates unused areas in core to make suffi- 
cient room for the incoming job, 

b. The swapper, which creates additional room in core by transferring jobs from core 
to disk. 

Therefore, when the scheduler is selecting the next job to be run, the swapper is bringing the next job 
to be run into core. The transfer from disk to core takes place while the central processor continues 
computation for the previous job. 
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7.2 PROGRAM SWAPPING 

Program swapping is performed by the monitor on one or more units of the system independent of the 
file structures that may also use the units. Swapping space is allocated and deallocated in clusters of 
IK words (exactly); this size is the increment size of the memory relocation and protection mechanism. 
Directories are not maintained, and retrieval information is retained in core. Most user segments are 
written onto the swapping units as contiguous units. Swapping time and retrieval information is, there- 
fore, minimized. Segments are always read completely from the swapping unit into core with one I/O 
operation. The swapping space on all units appears as a single system file, SWAP. SYS, in directory 
SYS in each file structure. This file is protected from all but privileged programs by the standard file 
protection mechanism (refer to Paragraph 6.2.3). 

The reentrant capability reduces the demands on core memory, swapping space, swapping channel, 
and storage channel; however, to reduce the use of the storage channel, copies of sharable segments 
are kept on the swapping device. This increases the demand for swapping space. To prevent the 
swapping space from being filled by user's files and to keep swapped segments from being fragmented, 
swapping space is preallocated when the file structure is refreshed. The monitor dynamically achieves 
the space-time balance by assuming that there is no shortage of swapping space. Swapping space is 
never used for anything except swapped segments, and the monitor keeps a single copy of as many seg- 
ments as possible in this space. (The maximum number of segments that may be kept may be increased 
by individual installations but is always at least as great as the number of jobs plus one.) If a shar- 
able segment on the swapping space is currently unused, it is called a dormant segment. An idle seg- 
ment is a sharable segment that is not used by users in core; however, at least one swapped-out user 
must be using the segment or it would be a dormant segment. 

Swapping disregards the grouping of similar units into file structures; therefore, swapping is done on a 
unit basis rather than a file structure basis. The units for swapping are grouped in a sorted order, re- 
ferred to as the active swapping list . The total virtual core, which the system can allocate to users, 
is equal to the total swapping space preallocated on all units in the active swapping list. In comput- 
ing virtual core, sharable segments count only once, and dormant segments do not count at all . The 
monitor does not allow more virtual core to be granted than the system has capacity to handle. 

When the system is started, the monitor reads the home blocks on all the units that it was generated to 
handle. The monitor determines from the home blocks which units are members of the active swapping 
list. This list may be changed at once-only time. The change does not require refreshing of the file 
structures, as long as swapping space was preallocated on the units when they were refreshed. All of 
the units with swapping space allocated need not appear in the active swapping list. For example: a 
drum and disk pack system should have swapping space allocated on both drum and disk packs. Then, 
if the drum becomes inoperable, the disk packs may be used for swapping without refreshing. 
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Users cannot proceed when virtual core is exhausted; therefore, FILSER is designed to handle a variety 
of disks as swapping media. The system administrator allocates additional swapping space on slower 
disks and virtually eliminates the possibility of exhausting virtual core; therefore, in periods of heavy 
demand, swapping is slower for segments that must be swapped on the slower devices. It is also unde- 
sirable to allow dormant segments to take up space on high-speed units. This forces either fragmenta- 
tion on fast units or swapping on slow units; therefore, the allocation of swapping space is important 
to overall system efficiency. 

The swapping allocator is responsible for assigning space for the segment the swapper wants to swap 
out. It must decide 

a. Onto which unit to swap the segment. 

b. Whether to fragment the unit if not enough contiguous space is available. 

c. Whether to make room by deleting a dormant segment. 

d. Whether to use a slower unit. 

The units in the active swapping list are divided into swapping classes, usually according to device 
speed. For jimplicity, the monitor assumes that all the units of class are first followed by all the 
units of class 1 . Swapping classes are defined when the file structures are refreshed and may be 
changed at once-only time. 

When attempting to allocate space to swap out a low or high segment, the monitor performs the follow- 
ing: 

Step Procedure 

1 The monitor looks for contiguous space on one of the units of the 
first swapping class. 

2 The monitor looks for noncontiguous space on one of the units in 
the same class. 

3 The monitor checks whether deleting one or more dormant segments 
would yield enough contiguous or noncontiguous space. 

If all of these measures fail, the monitor repeats the process on the next swapping class in the active 
swapping list. If none of the classes yield enough space, the swapper begins again and deletes 
enough dormant segments to fragment the segment across units and classes. When a deleted segment is 
needed again, it is retrived from the storage device. 
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7.3 DEVICE OPTIMIZATION 
7.3.1 Concepts 

Each I/O operafion on a unit consists of two steps: positioning and data transferring. To perform I/O, 
the unit must be positioned, unless it is already on a cylinder or is a non-positioning device. To posi- 
tion a unit, the controller cannot be performing a data transfer. If the controller is engaged in a data 
transfer, the positioning operation of moving the arm to the desired cylinder cannot begin until the 
data transfer is complete. 

The controller ensures that the arms have actually moved to the correct cylinder. This check is called 
verification , and the time required is fixed by hardware. If verification fails, the controller interrupts 
the processor, and the software recalibrates the positioner by moving it to a fixed place and beginning 
again. When verification is complete, the controller reads the sector headers to find the proper sector 
on which to perform the operation. This operation is called searching. Finally, the data is transferred 
to or from the desired sectors. To understand the optimization, the transfer operation includes verifi- 
cation, searching, and the actual transfer. The time from the initiation of the transfer operation to 
the actual beginning of the transfer is called the latency time. The channel is busy with the control- 
ler for the entire transfer time; therefore, it is important for the software to minimize the latency time 

The FILSER code, the routines that queue disk requests and make optimization decisions, handles any 
number of channels and controllers and up to eight units for each controller. Optimization is de- 
signed to keep: 

a. As many channels as possible performing data transfers at the same time. 

b. As many units positioning on all controllers, which are not already in position for 
a ddta transfer. 

Several constraints are imposed by the hardware. A channel can handle only one data transfer on one 
control at a time. Furthermore, the control can handle a data transfer on only one of its units at a 
time. However, the other units on the control can be positioning while a data transfer is taking place 
provided the positioning commands were issued prior to the data transfer. Positioning requests for a 
unit on a controller that is busy doing a data transfer for another of its units must be queued until the 
data transfer is finished. When a positioning command is given to a unit through a controller, the 
controller is busy for only a few microseconds; therefore, the software can issue a number of position- 
ing commands to different units as soon as a data transfer is complete. All units have only positioning 
mechanism that reaches each point; therefore, only one positioning operation can be performed on a 
unit at the same time. All other positioning requests for a unit must be queued. 



Disk latency optimization depends on FTDOPT which is normally off in the D ECsystem- 1 040 . If 
this switch is off, all requests are handled on a first-come first-served basis. 
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The software keeps a state code in memory for each active file, unit, controller, and channel, to re- 
member the status of the hardware. Reliability is increased because the software does not depend on 
the status information of the hardware. The state of a unit is as follows: 

I Idle; No positions or transfers waiting or being performed. 

SW Seek Wait; Unit is waiting for control to become idle so that it can in- 

itiate positioning (refer to Paragraph 6.2). 

S Seek; Unit is positioning in response to a SEEK UUO; no transfer of 

data follows. 

PW Position Wait; Unit is waiting for control to become idle so that it can 

initiate positioning. 

P Position; Unit is positioning; transfer of data follows although not nec- 

essarily on this controller. 

TW Transfer Wait; Unit is in position and is waiting for the controller/ 

channel to become idle so that it can transfer data. 

T Transfer; Unit is transferring; the controller and channel are busy per- 

forming the operation. 

Table 7-1 lists the possible states for files, units, controllers, and channels. 



Table 7-1 
Software States 



File^ 


Unit 


Controller 


Channel 


I 


I 

SW 

S 


I 


I 


PW 


PW 






P 


P 






TW 


TW 






T 


T 


T 


T 


Cannot be in S or SW state because SEEKs are 


ignored if the 


unit is not idle. 





7.3.2 Queuing Strategy 

When an I/O request for a unit is made by a user program because of an INPUT or OUTPUT UUO, one 
of several things can happen at UUO level before control is returned to the buffer-strategy module in 
UUOCON, which may, in turn, pass control back to the user without rescheduling. If an I/O request 
requires positioning of the unit, either the request is added to the end of the position-wait queue for 
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the unit if the control or unit is busy, or the positioning is initiated immediately. If the request does 
not require positioning, the data is transferred immediately. If the channel is busy, the request is 
added to the end of the transfer-wait queue for the channel . The control gives the processor an inter- 
rupt after each phase is completed. Optimization occurs at interrupt level when a position-done or 
transfer-done interrupt occurs. 

7.3.2.1 Position-Done Interrupt Optimization - The following action occurs only if a transfer-done 
interrupt does not occur first. Data transfer is started on the unit unless the channel is busy transfer- 
ring data for some other unit or control . If the channel is busy, the request goes to the end of the 
transfer-wait queue for that channel . 

7.3.2.2 Transfer-Done Interrupt Optimization - When a transfer-done interrupt occurs, all the 
position-done interrupts inhibited during the data transfer are processed for the controller, and the re- 
quests are placed at the end of the transfer-wait queue for the channel . All units on the controller 
are then scanned. The requests in the position-wait queues on each unit are scanned to see the re- 
quest nearest the current cyclinder. Positioning is begun on the unit of the selected request. All re- 
quests in the transfer-wait queue for all units on the channel that caused the interrupt are then 
scanned and the latency time is measured. The request with the shortest latency time is selected, and 
the new transfer begins. 

7.3.3 Fairness Considerations 

When the system selects the best task to run, users making requests to distant parts of the disk may not 
be serviced for a long time. The disk software is designed to make a fair decision for a fixed percent- 
age of time. Every n decisions the disk software selects the request at the front of the position-wait or 
transfer-wait queue and processes it, because that request has been waiting the longest. The value of 
n is set to 10 (decimal) and may be changed by redefining symbols with MONGEN . 

7.3.4 Channel Command Chaining 

7.3.4.1 Buffered Mode - Disk accesses are reduced by using the chaining feature of the data chan- 
nel . Prior to reading a block in buffered mode, the device independent routine checks to see if there 
is another empty buffer, and if the next relative block within the file is a consecutive logical block 
within the unit. If both checks are true, FILSER creates a command list to read two or more consecu- 
tive blocks into scattered core buffers. Corresponding decisions are made when writing data in buf- 
fered mode, and, if possible, two or more separate buffers are written in one operation. The command 
chaining decision is not made when a request is put into a position-wait or transfer-wait queue; 
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instead. It is postponed until the operation is performed, thus increasing the chances that the user 
program will have more buffers available for input or output. The default size of the channel com- 
mand list is 20 decimal words, and can be changed by redefining CCWMAX with MONGEN. 

7.3.4,2 Unbuffered Mode - Unbuffered modes do not use channel chaining, and therefore, read or 
write one command word at a time. Each command word begins at the beginning of a 128-word block. 
If a command word does not contain an even multiple of 128 words, the remaining words of the last 
block are not read, if reading, and are written with zeroes, if writing. 

7.4 MONITOR ERROR HANDLING 

The monitor detects a number of errors. If a hardware error is detected, the monitor repeats the oper- 
ation ten times. If the failure occurs eleven times in a row, it is classified as a hard error. If the op- 
eration succeeds after failing one to ten times, it is a soft error. 

7.4.1 Hardware Detected Errors 

Hardware detected errors are classified either as device error or as data errors. A device error indi- 
cates a malfunction of the controller or channel . A data error indicates that the hardware parity did 
not check or a search for a sector header either did not succeed or had bad parity (the user's data is 
probably bad). 

A device error sets the lO.DER bit in the channel status word, and a data error sets the lO.DTE bit. 

Disk units may have imperfect surfaces; therefore, a special no n- timesharing diagnostic program, 
MAP, is provided to initially find all the bad blocks on a specified unit. The logicol disk addresses of 
any bad regions of one or more bad blocks are recorded in the bad allocation table (BAT) block on the 
unit. The monitor allocates all storage for files; therefore, it uses the BAT block to avoid allocating 
blocks that have previously proven bad. The AAAP program writes two copies of the BAT block because 
the BAT block might be destroyed. If the MAP program is not used, the monitor discovers the bad re- 
gions when it tries to use them and adds this information to the BAT block. However, the first user of 
the bad region loses that part of his data. 

A hard data error usually indicates a bad surface; therefore, the monitor never returns the bad region 
to free storage. This results in the bad region causing an error only once. The bad unit and the logi- 
cal disk addr^s are stored in the retrieval information block (RIB) of the file when the file is CLOSEd 
or RESET and the extent of the bad region is determined. The origin and length of the bad region is 
stored in the bad allocation table (BAT) block. 
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7.4.2 Software Detected Errors 

The monitor mokes a number of software checks on itself. It checks the folded checksum (refer to Ap- 
pendix H) computed for the first word of every group and stored in the retrieval pointer. The monitor 
also checks for inconsistencies when comparing locations in the retrieval information block with ex- 
pected values (filename, filename extension, project -programmer number, special code, logical block 
number). The monitor checks for inconsistencies in the storage allocation table block when comparing 
the number of free clusters expected with the number of zeroes. A checksum error or an inconsistency 
error in the SAT block or RIB normally indicates that the monitor is reading the wrong block. When 
these errors occur, the monitor sets the improper mode error bit (lO.IMP) in the user channel status 
word and returns control to the user program. 

7.5 DIRECTORIES 
7.5.1. Order of Filenames 

In 5.02 and earlier monitors, the names of newly created files are appended to the directory if the di- 
rectory does not contain more than 64 filenames. If the directory contains more than 64 filenames, a 
second block is used for the new filenames. When filenames are deleted from the first block, entries 
from the second block are not moved into the first. When additional new files are created, their^names 
are added to the end of the first block of the directory instead of the end of the directory. Thus, the 
order of the filenames in the directory may not be according to the date of creation. 

In 5.03 and later monitors, if FTDUFD = 1, files are always entered in the directory in the order in 
which they are created. In the DECsystem-1040, FTDUFD is normally off indicating that the order of 
filenames is the same as in the 5.02 and earlier monitors. 

7.5.2 Directory Searches 

Table space in core memory is used to reduce directory searching times. The JBTPPB table contains 
pointers to a list of four-word blocks for the user's project-programmer number, one block for each file 
structure on which the user has a UFD . 

Four-word name and access blocks contain copies of LOOKUP information for recently-accessed files 
and may reduce disk accesses to one directory read for a LOOKUP on a recently-active file. Recent 
LOOKUP failures are also kept in core, but are deleted when space is needed. 

7.6 PRIORITY INTERRUPT ROUTINES 

7.6.1 Channel Interrupt Routines 

Each of the seven PI channels has two abolute locations associated with it in memory: 40+2n and 
41+2n, where n is a channel number (1-7). When an interrupt occurs on a channel, control is immedi- 
ately transferred to the first of the two associated locations (unless an interrupt on a higher priority 
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channel is being processed). For fast service of a single device, the first location contains either a 
BLKI or BLKO instruction. For service of more than one device on the same channel, the first loca- 
tion contains a JSR to location CHn in the appropriate channel interrupt routine. The JSR ensures 
that the current state of the program counter is saved . 

Each channel interrupt routine (mnemonic name, CHANn, where n is the channel number) consists of 
three separate routines: 



CHn: 



SAVCHn: 



XITCHn: 



The contents of the program counter is saved in location CHn. 
CHn+1 contains a JRST to the first device service routine in 
the interrupt chain. 

The routine to save the contents of a specified number of ac- 
cumulators. It is called from the device service routines with 
a JSR. 

The routine to restore saved accumulators. Device service 
routines exit to XITCHn with a POPJ PDP, if SAVCHn was 
previously called. 



7.6.2 Interrupt Chains 

Each device routine contains a device interrupt routine DEVINT where DEV is the three-letter mne- 
monic for the device concerned. This routine checks to determine whether an interrupt was caused by 
device DEV. The interrupt chain of a given channel is a designation for the logical positioning of 
each device interrupt routine associated with that channel . 

The monitor flow of control on the interrupt level through a chain is illustrated below. Channel 5 is 
used in the example. 

Explanation 

;control transferred here 
;on interrupt 

contents of PC saved here 
control transfers to first 
link in interrupt chain 

if PDP done bit is 
on, PTP was cause 
of interrupt - 
otherwise, go to 
next device. 



Monitor Routine 


Relevant Code 


Absolute 


52/JSRCH5 


Locations 


53/ 

4 


CHANS 


CH5: 




JRST PTPINT 




PTPINT: CON SO PTP,PTPDON 


PTPSER 


JRST LPTINT 



LPTSER 



\ 

LPTINT: CONSO LPT,LPTLOV+LPTERR+LPTDON 

JEN @ CHS ;three possible bits 

;may indicate that 
; ;LPT caused interrupt 
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When a real-time device is added to the interrupt chain (CONSO skip chain) by a RTTRP DUO (refer 
to Paragraph 3.8.1), the device is added to the front of the chain. After putting a real-time device 
on Channel 5 in single mode (refer to Paragraph 3.8.1), the chain is as follows: 



Monitor Routine 


Relevant Code 


Explanation 


Absolute 
Locations 


52/JSRCH5 
53/ 


;control transferred here 
;on interrupt 


CHAN5 


CHS: 

JRST RDTINT 

4 


; contents of PC saved here 
/control transfers to first 
;link in interrupt chain 


RTDEV 


RTDINT: CONSO RTD,BITS 
JRST PTPINT 

JRST <context switcher and 
dispatch for real-time 
interrupts > 




PTPSER 


PTPINT: CONSO PTP,PTPDON 
JRST LPTINT 


;if PTP done bit is 
;on, PTP was cause 
;of interrupt - 
/otherwise, go to 
;next device. 



LPTSER 



LPTINT:CONSO LPT, LPTLOV+LPTERR+LPTDON 

JEN @ CH5 ;three possible bits 

;may indicate that 
I ;LPT caused interrupt 



After putting a real-time device on channel 5 in normal block mode (refer to Paragraph 3.8.1), the 
chain is as follows: 



Explanation 



Monitor Routine 


Relevant Code 


Absolute 
Locations 


52/JSRCH5 
53/ 

i 


CHAN5 


CH5: 

JRST RTDINT 


RTDEV 


RTDINT:CONSO RTD,BITS 
JRST PTPINT 
BLKI RTD,POINTR 
JRST <context switcher > 
JEN @ CH5 



;control transferred here 
;on interrupt 

/contents of PC saved here 
/control transfers to first 
;link in interrupt chain 



(continued on next page) 
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Monitor Routine 



PTPSER 



LPTSER 
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Relevant Code 

PTPINT: CONSO PTP,PTPDON 
JRST LPTINT 



Explanation 

;if PTP done bit is 
;on, PTP was cause 
;of interrupt - 
; otherwise, go to 
;next device. 

LPTINTrCONSO LPT, LPTLOV+LPTERR+LPTDON 

JEN @ CHS ;three possible bits 

;may indicate that 
;LPT caused interrupt, 



1 



After putting a real-time device on channel 6 in fast block mode (refer to Paragraph 3.8.1), the 
is as follows: 



Cham 



Monitor Routine 

Absolute 
LocaticMis 

CHAN6 



Relevant Code 

54/BLKO RTD,POINTR 
55/JSR CH6 

CH6: 

JRST <context switcher > 



Explanation 

; control transferred 
;here on interrupt 

/contents of PC saved 
/control transfers to 
/context switcher. 



The exec mode trapping feature can be used with any of the standard forms of the RTTRP UUO: single 
mode, normal block mode, and fast block mode. The following examples illustrate the chain when 
used with each of the three modes. 

Single Mode (Exec Mode) 



Monitor Routine 


Relevant Code 


Absolute 


S2/JSRCHS 


Locations 


53/ 


CHANS 


CHS: 




JRST RDTINT 


RTDEV 


RTDINT: CONSO RTD,BITS 




JRST PTPINT 




JSR TRPADR 




JEN @CH5 



Explanation 

/control transferred here 
/on interrupt 

/contents of PC saved here 
/control transfers to first 
/link in interrupt chain 



(continued on next page) 



7-12 



-617- 

Single Mode (Exec Mode) (Cont) 
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Monitor RouMne 



PTPSER 



LPTSER 



Relevant- Code 

PTPINTtCONSO PTP^PTPDON 
JRST LPTINT 



Explanation 

;if PTP done bit is 
;on, PTP was cause 
;of interrupt - 
; otherwise, go to 
;next device . 

LPTINT:CONSO LPT, LPTLOV+LPTERR+LPTDON 

JEN @ CHS ;three possible bits 

;may indicate that 
'' ;LPT caused interrupt 



i 



Normal Block Mode (Exec Mode) 



Monitor Routine 

Absolute 
Locations 

CHANS 
RTDEV 



PTPSER 



LPTSER 



Explanation 

;control transferred here 
;on interrupt 

;contents of PC saved here 
;control transfers to first 
'fWvk in interrupt chain 



Relevant Code 

52/JSR CHS 
53/ 

■ i 

*CHS: 

JRST RTDINt 

i 

RTDINT rCONSO RTD,BITS 
JRStPfPINT 
BLKI RTb,POINTR 
JSR TR^ADR 
JEN @ CHS 

PDPINT: CONSO PTP,PTPDON ;if PTP done bit is 

JRST LPTINT ;on, PDP was cause 

;of interrupt - 
* ; otherwise, go to 

^ ;next device. 

LPTINT:CONSO LPT,LPTLOV+LPTERR+LPTDON 

JEN @ CHS ;three possible bits 

;may indicate that 
'• ;LPT caused interrupt. 



Monitor Routine 

Absolute 
Locations 



Fast Block Mode (Exec Mode) 

Relevant Code 

S4/BLKO RTD,POINTR 
SS/JSRCH6 

1 



Explanation 

;control transferred here 
;on interrupt 

(continued on next page) 
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Fast Block Mode (Exec Mode) (Cont) 

Monitor Routine Relevent Code Explanation 

CHAN6 CH6: ;contents of PC saved here 

JRST RDTINT ;control transfers to first 

i ;linl< in interrupt chain 

RTDEV RTDINT: JSR TRPADR 

JEN@CH6 



7.7 MEMORY PARITY ERROR ANALYSIS, REPORTING, AND RECOVERY^ 

The memory parity error analysis and recovery software allows the machine to run with PARITY STOP 
off, thereby gaining increased CPU speed (10% more on the KAIO processor and 100% more on the 
KIlO processor), better error reporting, and improved failsoft recovery. The analysis software considers 
its goals to be 

1) Never jeopardize the system or the user program by allowing it to conlrinue with bad 
data from memory. 

2) Always maintain the running of the system with the maximum number of users as possible 
as long as there is no possibility of violating the integrity of the system or the user 
program . 

In either case, complete information is printed for the operator so that he can reconfigure the memories 
and reload the system when necessary. Additional information is recorded on the disk by DAEMON 
for field service in order that the cause of the error can be located and fixed. 



7.7.1 Description of Analysis 

The error analysis software differentiates between user mode and executive mode when a parity error 
occurs. If the processor is executing in user mode and the user is enabled for parity trapping (refer 
to Paragraph 3.1.3.1), control is transferred to the user's routine. Otherwise, the execution of the 
user's I'ob is stopped and the user receives the error messages 

?ERROR IN JOB n 

?MEM PAR ERR AT USER PC nnnnnn 

Simultaneously, a request is made for the lowest priority channel routine to sweep through core in 
order to locate all words with bad memory parity, in case there is more than one word. During the 
sweep, all locations with bad parity are rewritten, so that subsequent references usually will not re- 
ceive a parity error. After the sweep of core is completed, all jobs (including the current job) with 



This feature depends on FTMEMPAR which is normally off in the DECsystem-1040. 
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porify errors in their low segments receive the above ERROR IN JOB message. All jobs with errors 
in their high segments are swapped out if the high segment has the hardware user-mode write protect 
bit set, since a copy exists on the swapping space. In this case recovery occurs for all jobs sharing 
the high segment except for the currently running job. If the high segment is not write protected for 
a fob (so that there is no copy on the disk), if the high segment is locked, or if one of the sharing 
job's low segment is locked, all jobs sharing the high segment are stopped and receive an error message 
since no recovery is possible. In addition, the segment name is cleared so that new users will receive 
q new copy from the file system on a R, RUN, or GET command or a RUN or GETSEG UUO. 

If the processor is in executive mode when the error occurs, the analysis procedure depends on the 
value of the PC. Two conditions are recognized as not being harmful: 

1) a parity error during the PI 7 sweep of memory. 

2) a parity error during the storing of data words around the location of a channel -detected 
memory parity error. 

If the PC is at the BLT instruction which moves user core to facilitate core allocation, the bad word 
is determined from the BLT pointer. If the pointer is in the protected part of the job data area, this 
area is cleared so the monitor will not attempt to use the bad words, since they contain executive 
mode addresses. In either cose, the user's iob is stopped and an error message is output to the user. 
In addition, the memory sweep procedure is invoked to find additional words with bad parity. 

If the PC is an executive mode location and there are no Pis in progress, the UUO is run to completion, 
the current user receives an error message, and the memory sweep procedure is invoked. If the sweep 
routine detects bad parity in an address within the monitor or detects no words with bad parity (because 
they have been rewritten on a read -pause -write instruction), the routine prints on the CTY (instead 
ofOPR), 

?EXEC PARITY HALT 

?n MEM PAR ERRS FROM aaaaaa TO bbbbbb ON CPUn FOR JOBx [program] 

and then HALTs. This message is printed without using the interrupt system in order to maximize the 
chances of the. message being output. Although the operator can attempt to continue the system by 
pushing the CONT console switch, this is not a recommended operator procedure (e.g., the monitor 
may have incorrect data thereby causing more damage). (Refer to MEMPAR in Notebook 8 of the 
DECsystem-10 Software Notebooks for complete operator instructions on memory parity error recovery.) 

If a PI is in progress when the parity error is detected, a sweep of core is made at the high priority 
APR PI level. If a word with bad parity is discovered in the monitor area or no parity errors are 
found, the monitor prints the above message to the operator and halts. The finding of words without 
bod parity is considered serious because the read -pause -write class instructions rewrite memory before 
the parity interrupt occurs so that the parity error is usually corrected. In this case, the operator re- 
ceives the message 

?0 MEM PAR ERRORS 
5.06 Monitor 7-15 March 1973 
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On all recoverable or non -recoverable parity errors, fhe operator receives on either OPR or CTY a 
message similar to the following: 

?nMEMPARERRSFROM aaaaaa TO bbbbbb ON CPUn for JOBx [program] 

preceded by 5 bells. This alerts him to potential problems and gives him the necessary information for 
reconfiguring the memories. In addition, the operator is notified of the jobs that have been stopped 
in case they are crucial to the operation of the system. If they are, he can take appropriate action 
to restart them. 

If the DFIO channel detects a memory parity error while reading for file I/O from memory, the user's 
iob is not stopped and the user does not receive an error message. Instead the error is treated as a 
device error and the iO.DER error bit is set. However, the operator receives the message 

?n MEM PAR ERRS FROM aaaaaa TO bbbbbb ON CHANNEL n 

where n is the logical channel number starting with the fastest device as defined by IVC)NGEN. For 
example, the fastest disk unit is on the first channel and the magnetic tape TMIOB control is on the last 
channel , 

If the DFIO channel detects a memory parity error while swapping a job out of core, the user's job is 
stopped and the user receives the following error message: 

7ERROR IN JOB n 

?SWAP OUT CHN MEM PAR ERR 

The operator receives the message 

?m MEM PAR ERRS FROM aaaaaa TO bbbbbb ON CHANNEL n FOR JOB x [prog] 

If the error is detected in a high segment on the swap out, all jobs using the high segment receive the 
error message. The high segment name is cleared so that new users will receive a new copy of the 
segment from the file system. 

On all parity errors detected by the processors or the channels, DAEMON is awakened to correct the 
information stored by the monitor's analysis routine. DAEMON writes this information in the hardware 
log file on the disk for the use of field service in diagnosing and solving the problem,, 
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APPENDIX A 

DECTAPE COMPATIBILITY 

BETWEEN DEC COMPUTERS 



The following chart illustrat-es the ability to read the indicated tapes with a suitable program. In 
general , the standard software of machines of one family will not read tapes written by the standard 
software of machines of a different family. 

The standard tapes of the PDP-1, PDP-4, PDP-6, PDP-7, PDP-9, PDP-10, PDP-ll, and PDP-15 
consist of 578 blocks of 128 36-bit words (256 18-bit words). The standard tapes of the PDP-15 and 
the PDP-8 family consist of 4096 blocks of 129 12-bit words (43 36-bit words). 
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APPENDIX B 

WRITING REENTRANT USER PROGRAMS 



B.l DEFINING VARIABLES AND ARRAYS 

The LOADER simplification makes It somewhat more difficult to define variables and arrays. The easiest 
way to define variables and arrays, so the resulting relocatable binary can be loaded on a one- or two- 
segment machine, is to put them all in a separate subprogram as internal global symbols using Block 1 
and Block N pseudo-ops. All other subprograms refer to this data as external global locations. Most 
reentrant programs have at least two subprograms, one for the definition of low segment locations and 
one for instructions and constants for the high segment. (This last subprogram must have either a HISEG 
pseudo-op or a TWOSEG pseudo-op followed by RELOC 400000.) Programs are self-initializing; there- 
fore, they clear the low segment when they are started although the monitor clears core when it assigns 
it to a user. 

Block 1 and Block N pseudo-ops cause the LOADER to leave indications in the |ob data area (LH of 
JOBCOR) so a monitor SAVE command will not write the low segment. This is advantageous in sharable 
programs for two reasons. It reduces the number of files in small DECtape directories (the maximum is 
22 files). Also, I/O is accomplished only on the first user's GET that initializes the high segment, 
but not on any subsequent user's GETs for either the high or low segment. 

B.2 EXAMPLE OF TWO-SEGMENT REENTRANT PROGRAM 

LOW SEGKiENT SUBFROGRAK'! 

TITLE LOW - EXAMPLE OE LOW SEGKENT SUB -PKOGHAi^. 
J0BVER=137 
LOG JOBVER 
3 AVERSIONS 

RELOC 
INTERNAL LOWBEG^DATA , DATA 1 ,DATAfc , TABLE, TABLE 1 

LOWBEG: 

DATA: BLOCK 1 

DATAl : BLOCK 1 

DATAP : BLOCK 1 

TABLE: BLOCK 10 

TABLE 1 ; BLOCK 10 

LOWEND-.-l J LAST LOCATION TO BE CLEARED 

END 
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HIGH SFGI^ENT SUbPHCGKAf-. : 

TITLE HIGH - EXAKPLE OF HIGH SEGMENT SUB-PROGKAKi 

IIISEG SOH TWOSEG 

;kELOC 400000 

EXTERN LOWBEG^LOWEND 

T=l 
BEGIN: SETZM LOWBEG JCLEAH DATA AREA 

MOVE I T, LOWBEG + 1 

HHLI T, LOWBEG 

BLT T^LQWEND 

.ViOVF T^DATAl iCO^.PUTE 

ADD I 1 f 1 

r-XVEM T^ nATA2 



TND BEGIN 5STARTI'\'G ADDRESS 



B.3 CONSTANT DATA 

Some reentrant programs require certain locations in the low segment to contain constant data, which 
does not change during execution. The initialization of this data happens only once after each GET, 
instead of after each START; therefore, programmers are tempted to place these constants in the sub- 
program that contains the definition of the variable data locations. This action requires the SAVE 
command to write the constants out and the GET command to load the constants again; therefore, the 
constant data should be moved by the programs from the high segment to the low segment when the rest 
of the low segment is being initialized. The exception is when the amount of code and constants in 
the high segment needed to initialize the low segment constants take up too much room in the high 
segment. In this case, it is best to have I/O in the low segment on each GET. A rule to follow in 
deciding between this high segment core space and the low segment GET I/O time isi; put the code 
in the high segment.if it does not put the high segment over the next IK boundary. 

B.4 SINGLE SOURCE FILE 

A second way of writing single save file reentrant programs is to have a single source file instead of 
two separate ones. This is more convenient, although it involves conditional assembly and, therefore, 
produces two different relocatable binaries. A number of system programs have been written this way. 
The idea is to hove a conditional switch which is 1 if a reentrant assembly and if a non-reentrant 
assembly. 
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Table C- 


1 










ASCII Card Codes 






ASCII 


Octcl 


Card 


ASCII 


Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


NULL 


00 


12-0-9-8-1 


@ 


100 


8-4 


CTRL-A 


01 


12-9-1 


A 


101 


12-1 


CTRL-B 


02 


12-9-2 


B 


102 


12-2 


CTRL-C 


03 


12-9-3 


C 


103 


12-3 


CTRL-D 


04 


9-7 


D 


104 


12-4 


CTRL-E 


05 


0-9-8-5 1 E 


105 


12-5 


CTRL-F 


06 


0-9-8-6 


F 


106 


12-6 


CTRL-G 


07 


0-9-8-7 


G 


107 


12-7 


CTRL-H 


10 


11-9-6 


H 


110 


12-8 


TAB 


11 


12-9-5 


I 


111 


12-9 


LF 


12 


0-9-5 


J 


112 


11-1 


VT 


13 


12-9-8-3 


K 


113 


11-2 


FF 


14 


12-9-8-4 


L 


114 


n-3 


CR 


15 


12-9-8-5 


M 


115 


11-4 


CTRL-N 


16 


12-9-8-6 


N 


116 


11-5 


CTRL-O 


17 


12-9-8-7 


O 


117 


11-6 


CTRL-P 


20 


12-11-9-8-1 


P 


120 


n-7 


CTRL-Q 


21 


11-9-1 


Q 


121 


11-8 


CTRL-R 


22 


11-9-2 


R 


122 


11-9 


CTRL-S 


23 


11-9-3 


S 


123 


0-2 


CTRL-T 


24 


9-8-4 


T 


124 


0-3 


CTRL-U 


25 


9-8-5 


U 


125 


0-4 


CTRL-V 


26 


9-2 


V 


126 


0-5 


CTRL-W 


27 


0-9-6 


W 


127 


0-6 


CTRL-X 


30 


1 1-9-8 


X 


130 


0-7 


CTRL-Y 


31 


n -9-8-1 


Y 


131 


0-8 


CTRL-Z 


32 


9-8-7 


Z 


132 


0-9 


ESCAPE 


33 


0-9-7 


] 


133 


12-8-2 


CTRL-\ 


34 


n -9-8-4 


\ 


134 


0-8-2 


CTRL-] 


35 


n -9-8-5 


] 


135 


n-8-2 


CTRL-t 


36 


11-9-8-6 


t A 


136 


11-8-7 


CTRL— 


37 


11-9-8-7 


*. 


137 


0-8-5 


SPACE 


40 




\~ 


140 


8-1 


NOTE: The A 


5CII character 


ESCAPE (octal 33) is also CTRL-C o 


n a termfnal . 
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Table C-1 (Cont) 










ASCII Card Codes 






ASCII 


Octal 


Card 


ASCII 


Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


1 


41 


12-8-7 


a 


141 


12-0-1 


II 


42 


8-7 


b 


142 


12-0-2 


# 


43 


8-3 


c 


143 


12-0-3 


$ 


44 


11-8-3 


d 


144 


12-0-4 


% 


45 


0-8-4 


e 


145 


12-0-5 


& 


46 


12 


f 


146 


12-0-6 




47 


8-5 


g 


147 


12-0-7 


( 


50 


12-8-5 


h 


150 


12-0-8 


) 


51 


n-8-5 


i 


151 


12-0-9 


* 


52 


11-8-4 


i 


152 


12-11-1 


+ 


53 


12-8-6 


k 


153 


12-11-2 




54 


0-8-3 


1 


154 


12-11-3 


/ 


55 


n 


m 


155 


12-11-4 




56 


12-8-3 


n 


156 


12-11-5 


/ 



57 


0-1 


o 


157 


12-11-6 


60 





P 


160 


12-11-7 


1 


61 


1 


q 


161 


12-11-8 


2 


62 


2 


r 


162 


12-11-9 


3 


63 


3 


s 


163 


11-0-2 


4 


64 


4 


t 


164 


11-0-3 


5 


65 


5 


u 


165 


11-0-4 


6 


66 


6 


V 


166 


11-0-5 


7 


67 


7 


w 


167 


11-0-6 


8 


70 


8 


X 


170 


11-0-7 


9 


71 


9 


y 


171 


11-0-8 




72 


8-2 


z 


172 


11-0-9 


, 


73 


11-8-6 


{ 


173 


12-0 


/ 

< 


74 


12-8-4 


1 


174 


12-11 




75 


8-6 


} 


175 


11-0 


> 


76 


0-8-6 


~ 


176 


n-0-1 


? 


T7 


0-8-7 


DEL 


177 


12-9-7 


NOTE: The/ 


^SCII characte 


rs } and ~ (octal 175 and 176) are 


treated by the 


monitor as 


ALT-MODE a 


nd are often c 


^nsidered the same as ESCAPE. 
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Table C-2 
DEC-029 Card Codes 





Octal 


Card 




Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


SPACE 


40 




@ 


100 


8-4 


1 


41 


11-8-2 


A 


101 


12-1 


II 


42 


8-7 


B 


102 


12-2 


# 


43 


8-3 


C 


103 


12-3 


$ 


44 


1 1-8-3 


D 


104 


12-4 


% 


45 


0-8-4 


E 


105 


12-5 


& 


46 


12 


F 


106 


12-6 


1 


47 


8-5 


G 


107 


12-7 


( 


50 


12-8-5 


H 


110 


12-8 


) 


51 


11-8-5 


I 


111 


12-9 


* 


52 


1 1-8-4 


J 


112 


11-1 


+ 


53 


12-8-6 


K 


113 


11-2 


/ 


54 


0-8-3 


L 


114 


11-3 


- 


55 


11 


M 


115 


11-4 


. 


56 


12-8-3 


N 


116 


11-5 


/ 


57 


0-1 


O 


117 


n-6 





60 





P 


120 


11-7 


1 


61 


1 


Q 


121 


11-8 


2 


62 


2 


R 


122 


11-9 


3 


63 


3 


S 


123 


0-2 


4 


64 


4 


T 


124 


0-3 


5 


65 


5 


U 


125 


0-4 


6 


66 


6 


V 


126 


0-5 


7 


67 


7 


W 


127 


0-6 


8 


70 


8 


X 


130 


0-7 


9 


71 


9 


Y 


131 


0-8 


: 


72 


8-2 


Z 


132 


0-9 


} 


73 


1 1-8-6 


[ 


133 


12-8-2 


< 


74 


12-8-4 


\ 


134 


11-8-7 


= 


75 


8-6 


3 


135 


0-8-2 


> 


76 


0-8-6 


t A 


136 


12-8-7 


? 


77 


0-8-7 


*"- 


137 


0-8-5 


NOTE: O 


ctal codes 0-37 and 140-177 are the same punches c 


js ASCII. 
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Table C-3 








DEC-026 Card Codes 








Ocfal 


Card 




Octal 


Card 


Characfer 


Code 


Punches 


Character 


Code 


Punches 


SPACE 


40 




@ 


100 


8-4 


1 


41 


12-8-7 


A 


101 


12-1 


II 


42 


0-8-5 


B 


102 


12-2 


# 


43 


0-8-6 


C 


103 


12-3 


$ 


44 


11-8-3 


D 


104 


12-4 


% 


45 


0-8-7 


E 


105 


12-5 


& 


46 


11-8-7 


F 


106 


12-6 


1 


47 


8-6 


G 


107 


12-7 


( 


50 


0-8-4 


H 


110 


12-8 


) 


51 


12-8-4 


I 


111 


12-9 


* 


52 


11-8-4 


J 


112 


11-1 


+ 


53 


12 


K 


113 


n-2 




54 


0-8-3 


L 


114 


11-3 


_ 


55 


11 


M 


115 


n-4 




56 


12-8-3 


N 


116 


11-5 


/ 


57 


0-1 


O 


117 


11-6 





60 





P 


120 


11-7 


1 


61 


1 


Q 


121 


11-8 


2 


62 


2 


R 


122 


11-9 


3 


63 


3 


S 


123 


0-2 


4 


64 


4 


T 


124 


0-3 


5 


65 


5 


U 


125 


0-4 


6 


66 


6 


V 


126 


0-5 


7 


67 


7 


W 


127 


0-6 


8 


70 


8 


X 


130 


0-7 


9 


71 


9 


Y 


131 


0-8 




72 


11-8-2/11-0 


Z 


132 


0-9 


. 


73 


0-8-2 


[ 


133 


11-8-5 


< 


74 


12-8-6 


\ 


134 


8-7 


= 


75 


8-3 


] 


135 


12-8-5 


> 


76 


n-8-6 


t A 


136 


8-5 


? 


77 


12-8-2/12-0 


*"- 


137 


8-2 


NOTE: 0< 


'Aa\ codes 0-37 and 140-177 ore the same punches a 


s ASCII. 
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c 




o 


ca 


I) 






3 






■ " 


n 






Q 


CO 


(1) 


Oi 


mi-. 


u 


^ 


> 


\- 


^ 





lO 
CO 


D 
t 




1 

D 








^ 




?? 




^ 




CO 


User 

Word 

Count 




o 

CO 


Sync 
Input 




O". 


3 -*- O <U 
L1-, U D CO 




00 
CM 


Echo 
Sup- 
press 




IN. 
CN 


u 




O 1 <" 

uj O CO Q. 








Cs| 


•to ■ 

II 




CM 


>- 1 

h- Q) 
1- OH 


g 
CL 










<N 


••- 




CO 
CM 


I/O 
Active 






I/O 
Active 






?^ 






CN 


o • 
o o 

sz 


Too 
Large 




Char- 
acter 
Lost 






O 

Cv) 


Echo 
Fail- 
ure 




On 


Ignore 
Inter- 
rupt 




CO 








TTY 
Not 
Assig- 
ned 
for 


image 

mode 

input 



I— 

CO 



a? 
.2 
*> 

(U 



O 



III 

o 



o 



§■» 

£ 'c 
o o 

o ^ 

Z -c 



Q) « 
^^ 

- E 

to «= 
CO <u 

00 9 



-Q it 

o H 
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3 .£ 



-c 
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D 





4- 



Q- 







L4- 


D .. 




"D 


o 




c 


to " 




O 


K- K 






}^Z 




U> 


UJ LU 




C 


OS 




0) 

a. 


^u_- 




? 


D fc 


. 


U 


^ z 


o 


c 


CM 1-1 


4) 




.■^ C 


3 


V) 


ih o 


D 


c 
o 


S-" 


> 


u 


O O) 


_c 


3i 


X o 






«> ^ 


^ 


4) 
O 


u> 






.■!: te 


_E 


> 


3 




D 






'I' -w 


O 






-D 


8- 


i 1 


3 


o 

0) 

_c 


UUO 
mally 


42 


J3 


£ 


CO 


■n 


91 
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CO _Q 
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CN 


CO 
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APPENDIX E 
ERROR CODES 



The error codes in Table E-1 are returned in AC on RUN and GETSEG UUOs, in location E + 1 on 
4-word argument blocks of LOOKUP, ENTER, and RENAME UUOs, and in the right half of location 
E + 3 on extended LOOKUP, ENTER, and RENAME UUOs. The codes are defined in the S.MAC 
monitor file. 



Table E-1 
Error Codes 



Symbol 



ERFNF% 

ERIPP% 

ERPRT% 

ERFBM% 

ERAEF% 

ERISU% 

ERTRN% 



ERNSF% 

ERNEC% 

ERDNA% 

ERNSD% 

ERILU% 



Code 



7 
10 

n 

12 
13 



Explanation 



File not found, illegal filename (0,*), filenames do not 
match (UPDATE), or RENAME after a LOOKUP failed. 

UFD does not exist on specified file structures. (Incor- 
rect project-programmer number.) 

Protection failure or directory full on DTA. 
File being modified (ENTER, RENAME). 

Already existing filename (RENAME) or different filename 
(ENTER after LOOKUP). 

Illegal sequence of UUOs (RENAME with neither LOOKUP 
nor ENTER, or LOOKUP after ENTER). 

a. Transmission, device, or data error (RUN, GETSEG 
only). 

b . Hardware-detected device or data error detected 
while reading the UFD RIB or UFD data block. 

c. Software-detected data inconsistency error detected 
while reading the UFD RIB or file RIB. 

Not a saved file (RUN, GETSEG only). 

Not enough core (RUN, GETSEG only). 

Device not available (RUN, GETSEG only). 

No such device (RUN, GETSEG only). 

Illegal UUO (GETSEG only). No two-register relocation 
capability. 
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Symbol 



ERNRM% 


14 


ERWLK% 


15 


ERNET% 


16 


ERPOA% 


17 


ERBNF% 


20 


ERCSD% 


21 


ERDNE% 


22 


ERSNF% 


23 


ERSLE% 


24 


ERLVL% 


25 


ERNCE% 


26 



ERSNS% 



Code 



27 



Table E-1 (Cont) 
Error Codes 



Explanation 



No room on this file structure or quota exceeded (over- 
drawn quota not considered). 

Write-lock error. Cannot write on file structure. 

Not enough table space in free core of monitor. 

Partial allocation only. 

Block not free on allocated position. 

Cannot supersede an existing directory (ENTER). 

Cannot delete a non-empty directory (RENAME). 

Sub-directory not found (some SFD in the specified path 
was not found) . 

Search list empty (LOOKUP or ENTER was performed on 
generic device DSK and the search list is empty). 

Cannot create a SFD nested deeper than the maximum 
allowed level of nesting. 

No file structure in the job's search list has both the 
no-create bit and the write-lock bit equal to zero and 
has the UFD or SFD specified by the default or explicit 
path (ENTER on generic device DSK only). 

GETSEG from a locked low segment to a high segment 
which is not a dormant, active, or idle segmesnt. (Seg- 
ment not on the swapping space.) 
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COMPARISON OF DISK-LIKE DEVICES 



Table F-1 
Disk Devices 



Device Name 

Manufacturer 

Device Type 
Controller 


Fixed- Head Disk 


Drum 


Removable Disk Pack(s) 


Burroughs 

RDIO 
RCIO 


Bryant 

RMIOB 
RCIO 


Memorex, ISS 


RP02 
RPIO 


RP03 
RPIO 


Maximum Disks per 
Controller 


4 


4 


8 


8 


Maximum Controllers 
per System 


2 


2 


3 


3 


Hardware Mnemonic 


DSK 


DSK 


DPC 


DPC 


Software Mnemonic 


FHA, FHB 


FHA, FHB 


DPA, DPB, 
DPC 


DPA, DPB, 
DPC 


Capacity Minimum 
(XI 0**6 words) 


.5 


.345 


5.2 


10.4 


Maximum (1 control) 
(XI 0**6 words) 


2 


1.38 


41.4 


82.8 


Blocks/Track 


20 


30 


10 


10 


Blocks/Cylinder 


4000 


2700 


200 


400 


Blocks/Unit 


4000 


2700 


40000 


80000 


Rotational 
Speed (rpm) 


1800 


3600 


2400 


2400 


Revolution 


33 


17 


25 


25 


Time (msec) 










128-Word Blocks/ 
Revolution 


20 


30 


10 


10 


Transfer Rate |js word 


13 


4.3 


15 


15 
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Table F-1 (Cont) 
Disk Devices 



Device Name 

Manufacturer 

Device Type 
Controller 


Fixed -Head Disk 


Drum 


Removable Disk Pack(s) 


Burroughs 

RDIO 
RCIO 


Bryant 

RMIOB 
RCIO 


Memorex, ISS 


RP02 
RPIQ 


RP03 
RPIO 


Seek Time 










Average (msec) 
Minimum (msec) 
Maximum (msec) 












50 
20 
80 


50 
20 
80 


Swapping Times (msec) 






(includes 30 ms verify) 


IK 
4K 
lOK 
25 K 


25 
73 
154 
358 


13 
27 
54 
120 


84 
144 
256 
589 


84 
144 
264 
589 


NOTE 




Although the Bryant drum is a drum in every sen^, its soft- 
ware mnemonic is still FHA because it is connected to the 
system through the fixed head disk control. 
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MAGNETIC TAPE CODES 



Table G-1 
ASCII Codes and BCD Equivalents 





Character 






Character 




ASCII 


Symbol 


BCD 


ASCII 


Symbol 


BCD 


040 


blank 


20 


100 


@ 


57 


041 


1 


52 


101 


A 


61 


042 


II 


17 


102 


B 


62 


043 


# 


32 


103 


C 


63 


044 


$ 


53 


104 


D 


64 


045 


% 


77 


105 


E 


65 


046 


& 


35 


106 


F 


66 


047 


' 


14 


107 


G 


67 


050 


( 


34 


110 


H 


70 


051 


) 


74 


111 


I 


71 


052 


* 


54 


112 


J 


41 


053 


+ 


60 


113 


K 


42 


054 




33 


114 


L 


43 


055 


/ 


40 


115 


M 


44 


056 




73 


116 


N 


45 


057 


/ 


21 


117 


O 


46 


060 





12 


120 


P 


47 


061 


1 


01 


121 


Q 


50 


062 


2 


02 


122 


R 


51 


063 


3 


03 


123 


S 


22 


064 


4 


04 


124 


T 


23 


065 


6 


05 


125 


U 


24 


066 


6 


06 


126 


V 


25 


067 


7 


07 


127 


W 


26 


070 


8 


10 


130 


X 


27 


071 


9 


11 


131 


Y 


30 


072 




15 


132 


Z 


31 


073 


. 


56 


133 


c 


75 


074 


< 


76 


134 


\ 


36 1 


075 


5 


13 


135 


] 


55 


076 


> 


16 


136 


t 


illegal 


077 


? 


72 


137 


*■ 


37 


t Code use 


"d for all illegal coc 


Jes. 
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When converl-ing from ASCII to BCD^ the following is done for ASCII codes 000-037 and 140-177: 

000 ignored . 

001-010 same as ASCII 134. 
Oil same as ASCII 040. 

012-014 constitutes end of line. 
015 ignored. 

016-031 same as ASCII 134. 
032 end of file. 

033-037 same as ASCII 134. 
140 sameas ASCII 134. 

141-172 same as ASCII 101-132. 
173-176 sameas ASCII 134. 
177 ignored. 
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APPENDIX H 

FILE RETRIEVAL POINTERS 



Sequential and random file access are handled more efficiently by the monitor if all the information 
describing the file can be kept in core at once. To understand this effect, it is necessary to know how 
the monitor accesses files. 

With each named file, UFD, and MFD, the monitor writes a special block containing necessary infor- 
mation needed to retrieve the data blocks that constitute the file. This block is called a retrieval 
information block, or RIB. 

Retrieval pointers in the RIB describe contiguous blocks of file storage space called groups. Each pointer 
occupies one word and has one of three forms: 

a. A group pointer 

b. An EOF pointer 

c. A change of unit pointer. 

H.l A GROUP POINTER 

A group pointer has three fields: 

a. A cluster count 

b. A folded checksum 

c. A cluster address within a unit. The width of each field may be specified at 
refresh time; therefore, the same code can handle a wider variety of sizes of 
devices. 

The cluster count determines the number of consecutive clusters that can be described by one pointer. 
The folded checksum is computed for the first word of the first block of the group. Its main purpose 
is to catch hardware or software errors when the wrong block is read. The folded checksum is not a 
check on the hardware parity circuitry. The size of the cluster address field depends on the largest 
unit size in the file structure and on the cluster size. A cluster address is converted to a logical block 
address by multiplying by the number of blocks per cluster. 
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H.1.1 Folded Checksum Algorithm 

This algorithm takes the low order n-bit byte, repeatedly adds it to the upper part of the word, and 

then shifts. The code is: 

LOOP: ADD T1,T 

LDB T*LOW ORDER N BITS OF Tl 

LSH Tl,-N iRIGHT SHIFT BY N BITS 

JUMPN Tl^LOOP 

DONE lANSWER IN T 

This scheme elminated the usual overflow problem associated with folded checksums and terminates as 
soon as there are no more bits to add. 

H.2 END-OF-FILE POINTER 

The EOF is indicated by a zero word. 

H.3 CHANGE OF UNIT POINTER 

A file structure may comprise more than one unit; therefore, the retrieval information block must indi- 
cate which unit the logical block is on. Because a file can start on one device and move to another, 
a method of indicating a change from one unit to another in the middle of the file is necessary. To 
show this movement, a zero count field indicates that the right half of the word specifies a change in 
unit, A zero count field contains a unit number with respect to the file structure. The first retrieval 
pointer, with respect to the RIB, always specifies a unit number. Bit 18 is 1 to guarantee that the word 
is non-zero; otherwise it might be confused with an EOF pointer. 

H.4 DEVICE DATA BLOCK 

The monitor keeps a copy of up to 10 retrieval pointers in core at once. Therefore, if a file is allocated 
in 10 or less contiguous blocks (i.e., described in 10 or less pointers), all of the retrieval information 
can be kept in core and no additional accesses to the RIB are necessary . 

H.5 ACCESS BLOCK 

Fbr each active file, the monitor keeps eight words of storage called an access block. These access 
blocks remain dormant in monitor core after a file is closed and are reclaimed only when the core space 
is necessary. Therefore, if a 4-word LOOKUP is done after a file has been active, access to the UFD 
and RIB blocks will not require I/O. 
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